{"repo":"tlgrcli/tlgr","free":true,"listed":false,"github":"https://github.com/tlgrcli/tlgr","clone":"git clone https://github.com/tlgrcli/tlgr.git","description":"CLI for Telegram — agent-friendly, daemon-based, with webhook event push.","language":"Python","stars":27,"topics":["telegram","telethon","automation"],"license":"MIT","category":"chat-messaging","readme_excerpt":"tlgr Full Telegram account control from the terminal. Agent-friendly, daemon-based, with webhook event push. For agents: Authentication requires human interaction (phone code, 2FA). Run tlgr account add yourself first, then hand the CLI to your agent. See AGENT.md for the full agent reference. Quickstart CLI Every Telegram operation available as a single command. Three output modes: human-readable tables (default), JSON ( --json ) for agents, and plain TSV ( --plain ) for piping. Shortcuts Common operations are available as top-level commands for quick access: Messages msg is an alias for message (e.g. tlgr msg send @user \"hello\" ). Chats Contacts Media Profile Accounts Daemon Global Flags Environment Variables All global flags can be set via environment variables: Variable Equivalent ---------- ------------ TLGR JSON=1 --json TLGR PLAIN=1 --plain TLGR ACCOUNT=alias --account alias TLGR ENABLE COMMANDS=cmd1,cmd2 --enable-commands cmd1,cmd2 TLGR AUTO JSON=1 Auto-switch to JSON when stdout is piped (non-TTY) Webhook -- Event Push tlgr pushes Telegram events to an external HTTP endpoint in real time. Designed for agentic interfaces like OpenClaw where an agent receives events and calls tlgr CLI commands to act. Configure in /.tlgr/webhook.toml : Events arrive as JSON with Authorization: Bearer : Gateway -- Background Jobs tlgr also ships with a deterministic, always-on Gateway that runs background jobs on your Telegram account. Define declarative pipelines in /.tlgr/jobs.yaml th","default_branch":null,"files":null,"tree":[],"storefront":"/r/tlgrcli","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/tlgrcli/tlgr/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}