What is this?
takopi is a Telegram bridge that lets you control coding agents (Codex, Claude Code, OpenCode, or Pi) from a Telegram chat, managing multiple repos and git worktrees, streaming progress, and resuming sessions anywhere.
takopi is a Telegram bridge that lets you control coding agents (Codex, Claude Code, OpenCode, or Pi) from a Telegram chat, managing multiple repos and git worktrees, streaming progress, and resuming sessions anywhere.Is takopi an agent itself, or does it sit between Telegram and my coding agent?It's a self-hosted bridge/bot you run on your own machine that routes Telegram messages to an existing coding engine (codex, claude, opencode, or pi) running locally — it doesn't run an agent itself.
It's a self-hosted bridge/bot you run on your own machine that routes Telegram messages to an existing coding engine (codex, claude, opencode, or pi) running locally — it doesn't run an agent itself.How do I get it running?Install uv, run takopi, and follow the setup wizard: create a bot token via @BotFather, pick a workflow (assistant, workspace, or handoff), connect your chat, and choose a default engine.
Install uv, run takopi, and follow the setup wizard: create a bot token via @BotFather, pick a workflow (assistant, workspace, or handoff), connect your chat, and choose a default engine.What do I need installed before running takopi?You need uv for installation, Python 3.14+, and at least one coding engine on PATH — codex, claude, opencode, or pi — plus an existing Anthropic or OpenAI subscription for that engine.
You need uv for installation, Python 3.14+, and at least one coding engine on PATH — codex, claude, opencode, or pi — plus an existing Anthropic or OpenAI subscription for that engine.How does resuming a session work, and is there a catch?Resume is stateless: you either keep replying in the Telegram chat to continue, or copy the printed resume line and paste it into your terminal to pick the same session back up there.
Resume is stateless: you either keep replying in the Telegram chat to continue, or copy the printed resume line and paste it into your terminal to pick the same session back up there.Does it run on Linux, macOS, and Windows?Yes, as a Python CLI installed via uv it runs cross-platform on Linux, macOS, and Windows.
Yes, as a Python CLI installed via uv it runs cross-platform on Linux, macOS, and Windows.What's the difference between the assistant, workspace, and handoff workflows?Assistant is an ongoing chat with auto-resume (recommended), workspace maps forum topics to specific repos/branches, and handoff lets you reply to continue while printing terminal resume lines for picking work up locally.
Assistant is an ongoing chat with auto-resume (recommended), workspace maps forum topics to specific repos/branches, and handoff lets you reply to continue while printing terminal resume lines for picking work up locally.How do worktrees work in a chat?Mentioning a branch name like /happy-gadgets @feat/memory-box spins up a dedicated git worktree for that branch, so you can run parallel agent sessions on different branches of the same repo without them colliding.
Mentioning a branch name like /happy-gadgets @feat/memory-box spins up a dedicated git worktree for that branch, so you can run parallel agent sessions on different branches of the same repo without them colliding.Can I extend takopi with custom engines or commands?Yes, takopi supports entrypoint-based plugins for adding new engines, transports, and commands, documented in docs/how-to/write-a-plugin.md.
Yes, takopi supports entrypoint-based plugins for adding new engines, transports, and commands, documented in docs/how-to/write-a-plugin.md.Can I send files to and from the repo through Telegram?Yes, takopi supports file transfer — you can send files into the repo or fetch files and directories back out through the chat.
Yes, takopi supports file transfer — you can send files into the repo or fetch files and directories back out through the chat.What are similar projects?1code, claude-code, agent-router, pstack-claude, billion-context, brigade, agentbox, casbin-gateway
1code, claude-code, agent-router, pstack-claude, billion-context, brigade, agentbox, casbin-gatewayWhich topics is it in?telegram-bot, git-worktrees, remote-control, messaging, telegram, opencode, coding-agents, plugin-system, workflow-automation, anthropic, coding-agent, claude
telegram-bot, git-worktrees, remote-control, messaging, telegram, opencode, coding-agents, plugin-system, workflow-automation, anthropic, coding-agent, claude