tgclilisted

# tgcli Telegram CLI with background sync. ## When to Use Use this skill when the user: - Wants to read or search Telegram messages - Needs recent updates or an inbox-style view of chats - Asks to send a Telegram message or file - Wants to download media or files from Telegram - Wants to look up channels, groups, or contacts - Needs archive/backfill sync for a chat ## Install ```bash npm install -g @kfastov/tgcli ``` Or: ```bash brew install kfastov/tap/tgcli ``` ## Authentication First-time setup needs Telegram API credentials from https://my.telegram.org/apps ```bash tgcli auth ``` ## Common Commands ### Reading ```bash tgcli channels list --limit 20 tgcli messages list --chat @username --limit 50 tgcli messages search "query" --chat @channel --source archive tgcli topics list --chat @channel --limit 20 ``` ### Files & Media ```bash tgcli media download --chat @channel --id 12345 tgcli send file --to @channel --file ./report.pdf --caption "FYI" ``` ### Writing ```bash tgcli send text --to @username --message "Hello" ``` ### Sync & Service ```bash tgcli sync --follow tgcli sync jobs add --chat @channel --min-date 2024-01-01T00:00:00Z tgcli service install tgcli service start ``` ### Contacts & Groups ```bash tgcli contacts search "alex" tgcli groups list --query "Nha Trang" ``` ## Output Formats All commands support `--json` for structured output: ```bash tgcli messages list --chat @username --limit 5 --json tgcli channels list --limit 10 --json ``` ## Not