Read and send your own Telegram chats from the terminal via the bundled `bin/tg` command. Logs in as your Telegram **user account** over MTProto (Telethon) — not a bot — so it sees every chat your account sees. `tg login` authenticates once (phone + code + 2FA), `tg chats` lists conversations, `tg folders` / `tg folder <name>` list and batch-read chat folders, `tg folder-add <folder> <chat>` folds a chat into a folder (dry-run unless `--yes`) and `tg chats --not-in-folder <folder>` finds chats sitting outside one, `tg read <name>` shows a thread, `tg search <text>` searches, `tg send <name> <text>` sends a message or a `--file` document (dry-run unless `--yes`), and `tg download <name>` saves attachments. Session and API credentials are stored chmod 600 in ~/.config/tg-cli. Use when the user wants to read, search, send, or download their personal Telegram messages and attachments.
2026-07-15