kfastovkfastovCommunity·1 Agent Skills Included

tgcli

Read, search, sync, and send Telegram messages from terminal

Reads and searches Telegram chats, channels, and contacts directly from the command line. Archives message history into a local database with background sync, eliminating manual scrolling and exporting. Sends text and files, downloads media, and manages groups with structured JSON output for fast automation.
npx skills add kfastov/tgcli --all -g -y

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install tgcli?

Run `npx skills add kfastov/tgcli --all -g -y` in your terminal to install this skill globally.

How to search Telegram messages from the terminal?

Run `tgcli messages search "query" --chat @channel --source archive` after authenticating with `tgcli auth`. Add `--json` for machine-readable output.

Does tgcli work with AI agents?

Yes. It includes an optional MCP server and a SKILL.md file, so agents in Claude Code, Cursor, and similar tools can list channels, read messages, and send files directly.

Does tgcli use the Telegram Bot API?

No. It connects through your personal account via MTProto, so it can access your own chats, channels, and contacts. You need free API credentials from my.telegram.org.

Can tgcli back up my Telegram chat history?

Yes. The `tgcli backfill` command archives full chat history into a local SQLite database, and `tgcli channels watch` keeps selected chats continuously synced.

Related Repositories in Content & Communication

View All in Content & Communication