🐙 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.
- 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
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 takopirun takopi and follow the instructions. it will help you create a bot token, set up the default chat, and set the default engine.
cd ~/dev/happy-gadgets
takopisend 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.
see docs/user-guide.md for configuration, worktrees, topics, file transfer, and more.
takopi supports entrypoint-based plugins for engines, transports, and commands.
see docs/plugins.md and docs/public-api.md.
see docs/specification.md and docs/developing.md.
takopi dev telegram group