telegramlisted

# Telegram automation Use `telegram-agent` to work with the user’s real Telegram account. Output is JSON on stdout: `{ ok, data }` on success or `{ ok: false, error, code }` on failure. Warnings go to stderr. Prefer `jq` for inspecting results. ## Setup If `telegram-agent` is unavailable, install it with `npm install -g telegram-agent`, then run `telegram-agent --version`. Read [references/installation.md](references/installation.md) only if installation fails or the user needs advanced setup. Do not ask the user to install the CLI manually. Otherwise verify the connection: ```bash telegram-agent me ``` The local daemon starts automatically and keeps the TDLib connection warm. Do not ask for Telegram application credentials in normal use; official binaries include them. ## Commands ```bash # Identity telegram-agent me telegram-agent info <id|@username|phone|link> # Chats telegram-agent chats list [--limit N] [--archived] [--unread] telegram-agent chats list --type user|bot|group|channel telegram-agent chats search "query" [--type chat|bot|group|channel] [--global] telegram-agent chats members <chat> [--limit N] [--query text] [--type bot|admin|recent] # Messages telegram-agent msg list <chat> [--limit N] [--offset-id N] telegram-agent msg list <chat> --since N [--query text] [--from @user] telegram-agent msg list <chat> --filter photo|video|document|url|voice|gif|music telegram-agent msg list <chat> --auto-download [--auto-transcribe] telegram-agent msg get <chat> <