https://github.com/banteg/takopi
he just wants to help-pi!
https://github.com/banteg/takopi
agent bridge claude codex opencode telegram worktree
Last synced: 18 days ago
JSON representation
he just wants to help-pi!
- Host: GitHub
- URL: https://github.com/banteg/takopi
- Owner: banteg
- License: mit
- Created: 2025-12-29T11:10:08.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-05-15T19:30:26.000Z (18 days ago)
- Last Synced: 2026-05-15T19:34:41.479Z (18 days ago)
- Topics: agent, bridge, claude, codex, opencode, telegram, worktree
- Language: Python
- Homepage: https://takopi.dev
- Size: 1.39 MB
- Stars: 998
- Watchers: 5
- Forks: 126
- Open Issues: 39
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- License: LICENSE
Awesome Lists containing this project
- awesome-agent-orchestrators - takopi - Telegram bridge for codex, claude code, opencode, pi. (Personal Assistants)
- awesome-personal-ai-assistants - takopi - Telegram bridge for multiple coding agents (Codex, Claude Code, OpenCode, pi). Manages projects and git worktrees, streams progress, and supports parallel runs across agent sessions. Works with voice notes and scheduled messages. `Python`  (Bridges & Orchestrators)
README
# takopi
🐙 *he just wants to help-pi*
telegram bridge for codex, claude code, opencode, pi. manage multiple projects and worktrees, stream progress, and resume sessions anywhere.
## features
- projects and worktrees: work on multiple repos/branches simultaneously, branches are git worktrees
- stateless resume: continue in chat or copy the resume line to pick up in terminal
- progress streaming: commands, tools, file changes, elapsed time
- parallel runs across agent sessions, per-agent-session queue with Codex steering/cancel controls
- works with telegram features like voice notes and scheduled messages
- file transfer: send files to the repo or fetch files/dirs back
- group chats and topics: map group topics to repo/branch contexts
- works with existing anthropic and openai subscriptions
## requirements
`uv` for installation (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
python 3.14+ (`uv python install 3.14`)
at least one engine on PATH: `codex`, `claude`, `opencode`, or `pi`
## install
```sh
uv tool install -U takopi
```
## setup
run `takopi` and follow the setup wizard. it will help you:
1. create a bot token via @BotFather
2. pick a workflow (assistant, workspace, or handoff)
3. connect your chat
4. choose a default engine
workflows configure conversation mode, topics, and resume lines automatically:
- **assistant**: ongoing chat with auto-resume (recommended)
- **workspace**: forum topics bound to repos/branches
- **handoff**: reply-to-continue with terminal resume lines
## usage
```sh
cd ~/dev/happy-gadgets
takopi
```
send a message to your bot. prefix with `/codex`, `/claude`, `/opencode`, or `/pi` to pick an engine. reply to continue a thread.
register a project with `takopi init happy-gadgets`, then target it from anywhere with `/happy-gadgets hard reset the timeline`.
mention a branch to run an agent in a dedicated worktree `/happy-gadgets @feat/memory-box freeze artifacts forever`.
inspect or update settings with `takopi config list`, `takopi config get`, and `takopi config set`.
see [takopi.dev](https://takopi.dev/) for configuration, worktrees, topics, file transfer, and more.
## plugins
takopi supports entrypoint-based plugins for engines, transports, and commands.
see [`docs/how-to/write-a-plugin.md`](docs/how-to/write-a-plugin.md) and [`docs/reference/plugin-api.md`](docs/reference/plugin-api.md).
## development
see [`docs/reference/specification.md`](docs/reference/specification.md) and [`docs/developing.md`](docs/developing.md).