https://github.com/banteg/takopi
he just wants to help-pi!
https://github.com/banteg/takopi
bridge codex telegram
Last synced: 22 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 (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-01-12T19:24:41.000Z (29 days ago)
- Last Synced: 2026-01-12T20:00:51.628Z (29 days ago)
- Topics: bridge, codex, telegram
- Language: Python
- Homepage: https://pypi.org/project/takopi/
- Size: 775 KB
- Stars: 295
- Watchers: 2
- Forks: 34
- Open Issues: 8
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- License: LICENSE
Awesome Lists containing this project
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
- 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).
## community
[takopi dev](https://t.me/+jFvQTLE8m183MjBi) telegram group