The terminal bridge connects a running terminal agent to your Telegram bot, so you can drive and watch a coding agent — GLAI, Claude Code, Codex, or Gemini — from your phone. Start a long task at your desk, then steer it, answer its questions, and receive its results in Telegram while you are away.
Why use it
The agent terminal is powerful but tied to your machine. The bridge lifts that to your phone:
- Answer prompts remotely — when the agent asks a question or needs a decision, reply in Telegram and it keeps going.
- Watch progress — the agent’s output is mirrored to the chat, cleaned of terminal noise.
- Feed it images — send a photo and it lands on the board with its path passed to the agent.
- Collect results — generated media on the board is forwarded to the chat.
Enable it
The bridge stays completely off until you switch it on in both halves:
- Open a board’s agent terminal and click the bot icon in the toolbar — it turns green. If you have more than one bot configured, the icon opens a menu so you can choose which bot this terminal uses.
- In the bot you selected, send
/terminal.
Now the chat and the terminal are linked. Type in Telegram and the agent sees it; the agent’s replies come back to the chat.
The bridge needs the Telegram bot configured and running. See Connecting the Bot for setup.
How it routes
- You → agent — your Telegram message is typed into the terminal and submitted, exactly as if you typed it at the keyboard.
- Agent → you — terminal output is batched, stripped of colors/spinners/redraws, and sent to the chat as readable messages.
- Media — photos you send are saved to the connected board and their path is given to the agent; new board media is forwarded back to you.
Turn it off
Send /stopterminal, send any other bot command, or click the green bot icon again. Quitting the app also ends it. Nothing runs or is remembered once it is off.
Notes
- Each bot bridges one terminal and one chat at a time. With several bots configured you can run several terminals at once, each connected to a different bot — see Adding extra bots. When the agent sends media (“send me that”), it goes only to the bot that terminal is connected to.
- Telegram control of the agent is a Pro feature.
- For the mobile-side walkthrough, see Controlling the Terminal.
Leave a Reply