The project's README from github.com/banteg/takopi. As one markdown file: README.md.
🐙 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.
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
uv tool install -U takopi
run takopi and follow the setup wizard. it will help you:
workflows configure conversation mode, topics, and resume lines automatically:
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 for configuration, worktrees, topics, file transfer, and more.
takopi supports entrypoint-based plugins for engines, transports, and commands.
see docs/how-to/write-a-plugin.md and docs/reference/plugin-api.md.