tg-cli

# tg-cli Skill CLI tool for Telegram — sync chats, search messages, filter keywords, send messages, and monitor groups. ## Prerequisites ```bash # Install (requires Python 3.10+) uv tool install kabi-tg-cli # Or: pipx install kabi-tg-cli # Upgrade to latest (recommended to avoid API errors) uv tool upgrade kabi-tg-cli # Or: pipx upgrade kabi-tg-cli ``` ## Authentication Uses your Telegram account (MTProto). Built-in Telegram Desktop API credentials are used by default — no application needed. ```bash tg chats # First run: enter phone + verification code tg whoami # Check current user # Optional: use your own app credentials export TG_API_ID=123456 export TG_API_HASH=your_telegram_app_hash ``` ## Command Reference ### Telegram Operations ```bash tg chats # List joined chats tg chats --type group # Filter by type tg status # Check auth/session status tg status --yaml # Structured auth status tg whoami # Show current user info tg whoami --yaml # Preferred structured output for agents tg history CHAT -n 1000 # Fetch historical messages tg sync CHAT # Incremental sync (only new) tg sync-all # Low-level sync for all current dialogs tg refresh # Recommended daily refresh entrypoint tg listen # Real-time listener tg listen --persist ...