# banteg/takopi

he just wants to help-pi!

Repository: https://github.com/banteg/takopi
Canonical: https://ross.abutalabs.com/products/takopi
Homepage: https://takopi.dev
Language: Python
License: MIT
License Family: permissive
Topics: bridge, codex, telegram, agent, claude, opencode, worktree
Last push: 2026-05-25T18:54:43+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 84, release rhythm 85, longevity 17
- inputs: {"age_days": 247, "days_push": 100, "days_rel": 100, "gap_med": 0.0, "n_releases_24m": 41}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1047, forks 136 (observed 2026-08-28T04:03:22.188921+00:00)

## What it is
Takopi is a Python CLI tool that bridges coding agent CLIs (Codex, Claude Code, OpenCode, Pi) to Telegram, letting you send tasks from your phone and stream progress live. It manages multiple projects and git worktrees, supports parallel agent sessions, and offers stateless resume lines to continue sessions in the terminal.

## Use cases
- run coding agents from telegram on my phone
- control claude code remotely via telegram
- manage multiple repos and git worktrees with ai agents
- resume coding agent sessions between telegram and terminal
- stream agent progress and file changes to a chat
- run parallel agent tasks across branches
- send voice notes as prompts to coding agents
- transfer files between telegram and my repo

## When to choose
- you already use Codex, Claude Code, OpenCode, or Pi and want remote access via Telegram
- you juggle multiple repos/branches and want topic- or worktree-based agent workflows
- you want to kick off tasks from mobile and pick them up at the terminal later
- you want to reuse existing Anthropic/OpenAI subscriptions instead of API keys

## When to avoid
- you need a self-hosted web UI instead of Telegram as the interface
- you don't want your dev machine reachable via a messaging platform
- you use agent CLIs other than Codex, Claude Code, OpenCode, or Pi without writing a plugin
- you need a fully managed cloud service rather than a local tool

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, chatbot, cli, developer-tools, workflow-automation
- domain: developer-tools, messaging-platforms
- platform: python, cli, cross-platform
- tags: telegram-bridge, coding-agents, claude-code, codex, opencode, git-worktrees, session-resume, progress-streaming, ai-agents, automation, command-line, telegram

## Member repositories
- banteg/takopi (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:22.188921+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:01:05.490099+00:00, confidence not recorded.
  - readme: https://github.com/banteg/takopi (fetched 2026-08-28T04:03:22.188921+00:00, sha 129309d74401)
  - homepage: https://takopi.dev (fetched 2026-08-29T13:02:47.691867+00:00, sha 397508641a16)
  - site_page: https://takopi.dev/tutorials/install (fetched 2026-08-29T13:02:47.700569+00:00, sha 30b735493885)
  - registry_pypi: https://pypi.org/pypi/takopi/json (fetched 2026-08-29T13:02:47.704546+00:00, sha e7bb1a759489)
  - site_page: https://takopi.dev/reference/changelog (fetched 2026-08-29T13:02:47.702718+00:00, sha 122d79bc61a5)
- Data as of 2026-08-30T08:39:29.467469+00:00.