Controlling the Terminal

The Telegram bot can connect to the app’s agent terminal so you can watch and drive a running agent (Claude Code, Codex, Gemini, or any shell command) from your phone. Output streams to Telegram; whatever you type in Telegram is typed into the terminal and submitted. Media flows both ways.

This is off by default. It only starts when you turn it on in two places — the app and the bot — so nothing is shared until you ask for it.

Turn it on

1. In the app — open a board’s agent terminal and click the bot icon in the terminal toolbar. It turns green to show this terminal is now sharing. A short explainer appears the first time. If you have added extra bots, the bot icon opens a small menu — pick which bot this terminal shares with (Default, Bot 1, …). With only the Default bot configured, the icon is a simple on/off toggle.
2. In Telegram — send /terminal to the bot you selected. The bot replies that it is connected and which board the terminal belongs to.

Both steps are required. If you send /terminal before clicking the bot icon, the bot tells you no terminal is sharing yet. If you message a different bot than the one you picked, nothing happens — send /terminal to the bot shown in the terminal’s bot menu.

What happens while connected

• Terminal → Telegram — what the agent prints is mirrored to the chat, cleaned up (colors, spinners, and redraw noise are stripped) and batched so you get readable messages instead of raw escape codes.
• Telegram → terminal — any normal message you send is typed into the terminal and submitted with Enter, so the agent receives it and responds immediately.
• Photos → board + terminal — a photo you send is saved to the connected board and its file path is handed to the agent, so you can say “use this image” and the agent can open it.
• New board media → Telegram — when new media lands on the connected board (for example, the agent generates an image), it is forwarded to the chat. Media that came from Telegram is not echoed back.

Turn it off

Any of these stops terminal sharing:

• Send /stopterminal in the bot.
• Send any other command (/image, /boards, …) — issuing a command always drops out of terminal mode, then runs that command.
• Click the green bot icon in the app again — this stops the terminal → Telegram direction and clears the queue.

Good to know

• One terminal per bot — each bot bridges one terminal and one chat at a time. With several bots you can run several terminals at once, each connected to a different bot. Pointing the same terminal at a different bot (or arming a second terminal to a bot that’s already in use) moves the connection.
• Private by design — messages are only injected while a terminal is armed in the app and a chat is linked. Quitting the app or restarting the bot returns everything to off.
• Pro feature — like the rest of the bot’s advanced features, terminal control requires a Pro license.

Where to go next

• Connecting the Bot
• Saving Media from Telegram
• Telegram Terminal Bridge