Skip to content

Takopi documentation

Takopi runs coding agents on your computer and bridges them to Telegram. Send tasks from anywhere, watch progress stream live, pick up when back at the terminal. Scale from quick one-offs to multi-project workflows with topics and parallel worktrees.

Quick start

uv tool install -U takopi
takopi --onboard

Onboarding walks you through bot setup and asks how you want to work. Full install guide →

Pick your workflow

  • Assistant

    Ongoing chat. New messages auto-continue; /new to reset.

    Best for: solo work, natural conversation flow.

    Get started →

  • Workspace

    Forum topics bound to projects and branches.

    Best for: teams, organized multi-repo workflows.

    Set up topics →

  • Handoff

    Reply-to-continue. Copy resume lines to your terminal.

    Best for: explicit control, terminal-first workflow.

    Get started →

You can change workflows later by editing ~/.takopi/takopi.toml.

Tutorials

Step-by-step guides for new users:

  1. Install & onboard — set up Takopi and your bot
  2. First run — send a task, watch it stream, continue the conversation
  3. Projects & branches — target repos from anywhere, run on feature branches
  4. Multi-engine — use different engines for different tasks

How-to guides

Reference

Exact options, defaults, and contracts: