public-clispublic-clisOfficial·1 Agent Skills Included

tg-cli

Sync, search, and export Telegram chats from the terminal

Syncs Telegram chats into a local SQLite cache for fast keyword and regex search. Browses recent messages, top senders, and timelines without opening the Telegram app. Exports conversations as text, JSON, or YAML and keeps a near-real-time cache with scheduled refresh. Gives agents structured YAML output for quick message retrieval and analysis.
npx skills add public-clis/tg-cli --all -g -y

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install tg-cli?

Run `npx skills add public-clis/tg-cli --all -g -y` in your terminal to install this skill globally for your agent.

How to search Telegram messages from the terminal?

Run `tg refresh` to sync your chats locally, then use `tg search "keyword" --yaml` to find matching messages instantly from the local cache.

Does tg-cli need a Telegram bot token?

No. It uses your own Telegram account over MTProto with built-in Telegram Desktop credentials, so no bot or app registration is required.

Does tg-cli work with Claude Code and other agents?

Yes. It ships a standard SKILL.md and outputs structured YAML by default, so agents like Claude Code, Cursor, and Codex can call it directly.

Can I keep my Telegram cache updated automatically?

Yes. Use `tg listen --persist` for a near-real-time cache, or schedule `tg refresh` with the included cron and systemd timer examples.

Related Repositories in Content & Communication

View All in Content & Communication