# tlgr > Lets your agent read and act on your own Telegram account through the tlgr CLI: catch up on chats, search, send, reply and manage groups. tlgr is a command-line client for a personal Telegram account, built for agents. This is its Agent Skill: it teaches your agent to drive the tlgr CLI, which talks to Telegram over MTProto as your own user account (not a bot) through a local daemon, with JSON output and stable exit codes for every command. What you can do with it - Catch up on every unread chat without sending read receipts, read history and search a chat - Send, reply to, edit, forward and schedule messages, with Markdown formatting and long-text splitting - Manage chats, groups, channels, folders and contacts, plus reactions, polls, media, stickers and stories - Push Telegram events to your own webhook so an agent can react to new messages - Use several accounts side by side, each with its own alias How it connects - Install the CLI with pipx install tlgr-cli, then add the skill with npx skills add tlgrcli/tlgr (or the tlgr Claude Code plugin from the same repository). The maker documents Claude Code, Codex, Cursor and OpenClaw. - Log in with your phone number and the API ID and hash you get from Telegram; your agent runs the steps, and you only read it the login code. - The daemon runs locally on macOS or Linux and keeps your session on your machine. Good to know - It acts as you: messages, reactions and read receipts come from your account. Opening a chat sends a read receipt the other side sees, so the skill prefers the silent catch-up commands. - The skill tells your agent to preview destructive actions with --dry-run and to confirm with you before deleting, leaving, blocking or messaging someone new. - Secrets are passed through environment variables, stdin or files, never on the command line. It honours Telegram's rate limits and waits when told to. - A community project, not made by Telegram. MIT licensed. - Type: Skill - Made by: tlgrcli - Category: Communication - Formats: Skills - Version: 73472ed - Website: https://github.com/tlgrcli/tlgr - Source: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr - Page: https://pluginboard.ai/skills/tlgr ## Works with - ChatGPT - Claude - Gemini - GitHub Copilot - Cursor - Claude Code - Codex - Antigravity - Gemini CLI - Replit - OpenClaw - OpenCode - Hermes Agent ## Install ### ChatGPT In ChatGPT: Download the tlgr folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans. View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Claude In Claude (web or desktop): Download the tlgr folder and zip the folder itself, then upload it in Customize → Skills. View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Gemini In Gemini: Download the tlgr folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it). View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### GitHub Copilot Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.copilot/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Cursor Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.cursor/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Claude Code Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.claude/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr Or as a Claude Code plugin: ```text /plugin marketplace add tlgrcli/tlgr /plugin install tlgr@tlgr ``` ### Codex Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.agents/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Antigravity In Antigravity: Copy the tlgr folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI). View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Gemini CLI Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.gemini/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Replit Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr .agents/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### OpenClaw Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.openclaw/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### OpenCode Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.config/opencode/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr ### Hermes Agent Run in your terminal: ```shell npx -y degit tlgrcli/tlgr/plugin/skills/tlgr ~/.hermes/skills/tlgr ``` View the folder on GitHub: https://github.com/tlgrcli/tlgr/tree/HEAD/plugin/skills/tlgr --- From Pluginboard (https://pluginboard.ai).