Telegram Agents for Herdr plugin
A Herdr plugin that gives every coding agent its own Telegram topic, with status in the icon and messages both ways.
- 88 ★ on the repository
- Last commit
Extended access
Why this level
- The bot sees agent output and attachments, and a control-mode recipient types with the session's permissions
- Messages pass through Telegram servers
Install
- Works in
Manual install
herdr plugin install permgps/herdr-telegram-agentsHerdr downloads a signed, checksum-verified release binary. Then the setup action runs.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The bot sees agent output and attachments, and a control-mode recipient types with the session's permissions
- Messages pass through Telegram servers
This is third-party code. Review the repository files before installing.
What it does
A Herdr plugin links running coding agents to a Telegram forum group. Each live agent gets its own topic: the agent's questions and completion posts arrive there, and replies and command buttons go back to the agent. When an agent needs an answer, the bot can ring the operator in a private chat. Inside a topic, `/screen` shows the screen or the last readable reply, `/keys` sends raw keys and `/git` shows allow-listed repository information. Photos, documents, voice notes and video are saved to the plugin inbox and passed to the agent as file paths. In the General topic `/status` lists all agents, `/new` starts one and `/options` opens the settings panel.
Who it is for. Operators who keep several agents running in Herdr and want to watch them and answer them from a phone.
Good fit when
- An agent has finished or asked a question while its owner is away from the computer.
- A teammate picks up the agent's work while the owner is offline, with control rights granted through `/share`.
- A client or reviewer watches the agent work in read-only mode.
- A screenshot or document goes to the agent from chat and arrives as a file path.
Not a fit when
- Agents run outside Herdr: the plugin works only inside it.
- Nobody may be given access to the agent's terminal: in control mode the recipient types with the session's permissions on your machine.
- The Telegram group has no Topics mode: every agent needs its own topic.
Example request
Show the screen of the agent in the database migration topic and send its last reply.Limitations
Requires Herdr 0.7.5 or newer, a bot token from @BotFather and a Telegram supergroup with Topics enabled. The installer needs `sh` and `curl` on macOS and Linux or PowerShell 5.1 or newer on Windows. Prebuilt binaries cover macOS and Linux on amd64 and arm64 and Windows on amd64. Private access for other people needs Threaded Mode enabled in BotFather. Readable OpenCode replies appear after `herdr integration install opencode`. The bot token is stored by the plugin, and control mode gives the recipient input into the agent session.
How to disable. Remove the plugin with Herdr and revoke the bot token in @BotFather. Delete the topics in the group by hand.
FAQ
What is needed to install it?
Herdr 0.7.5 or newer, a bot from @BotFather and a supergroup with topics. After that `herdr plugin install permgps/herdr-telegram-agents` and the setup action are enough.
How do I lend an agent to another person?
The person messages the bot once, you run `/share` in the agent's topic, pick them and choose a duration: an hour, a day, seven days or until revoked. Rights are read or control, and `/shares` changes or revokes access.
Does the recipient see my secrets?
No, secrets are always masked in what they receive. The recipient sees only the agents you shared with them.
How do I update the plugin?
Open `/options` in General and press Check for updates, then Update separately. Only releases signed by the maintainer key are offered, and there are no scheduled checks or unattended installs.
Which agents are supported?
Readable replies and the screen work for OpenCode, Codex, Antigravity, Pi and Muse, and the dashboard shows Codex and Claude usage windows. Other agents appear in the topic status.
Discussion
No questions or reviews yet.
Related
PluginsA herdr pane that draws an agent swarm as a live graph with attempts, review gates and evidence, so large runs stay readable.
A Telegram bridge for Claude Code, Codex, Gemini and Pi terminal agents: sessions stay in the terminal, replies come from a phone.
hermitd runs an always-on Claude Code agent on your machine: tasks from chat, scheduled checks and saved state after a restart.
A package for the Pi agent: async subagents run in parallel in Herdr panes and results return on their own.
A Hermes Agent plugin with a Relay server: chat, voice and a terminal on Android, plus a desktop CLI for the agent's tools
Pi extension for background subagents: parallel delegation, a Manager, Lead and Agent chain and supervision in herdr
README in short
Covers signed-release installation, bot setup, topic commands, sharing an agent with another person and updates.