takopi 0.9.0__tar.gz

takopi-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 banteg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

takopi-0.9.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.3
+Name: takopi
+Version: 0.9.0
+Summary: Telegram bridge for Codex, Claude Code, and other agent CLIs.
+Author: banteg
+License: MIT License
+         
+         Copyright (c) 2025 banteg
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Dist: anyio>=4.12.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: markdown-it-py
+Requires-Dist: msgspec>=0.20.0
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: structlog>=25.5.0
+Requires-Dist: sulguk>=0.11.1
+Requires-Dist: typer>=0.21.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/banteg/takopi
+Project-URL: Issues, https://github.com/banteg/takopi/issues
+Project-URL: Repository, https://github.com/banteg/takopi
+Description-Content-Type: text/markdown
+
+# takopi
+
+🐙 *he just wants to help-pi*
+
+telegram bridge for codex, claude code, opencode, pi, and [other agents](docs/adding-a-runner.md). manage multiple projects and worktrees, stream progress, and resume sessions anywhere.
+
+## features
+
+projects and worktrees: register repos with `takopi init`, target them via `/project`, route to branches with `@branch`.
+
+stateless resume: continue a thread in the chat or pick up in the terminal.
+
+progress updates while agent runs (commands, tools, notes, file changes, elapsed time).
+
+robust markdown rendering of output with a lot of quality of life tweaks.
+
+parallel runs across threads, per thread queue support.
+
+`/cancel` a running task.
+
+## requirements
+
+- `uv` for installation (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
+- python 3.14+ (uv can install it: `uv python install 3.14`)
+- at least one engine installed:
+  - `codex` on PATH (`npm install -g @openai/codex` or `brew install codex`)
+  - `claude` on PATH (`npm install -g @anthropic-ai/claude-code`)
+  - `opencode` on PATH (`npm install -g opencode-ai@latest`)
+  - `pi` on PATH (`npm install -g @mariozechner/pi-coding-agent`)
+
+## install
+
+- `uv python install 3.14`
+- `uv tool install -U takopi` to install as `takopi`
+- or try it with `uvx takopi@latest`
+
+## setup
+
+run `takopi` and follow the interactive prompts. it will:
+
+- help you create a bot token (via @BotFather)
+- capture your `chat_id` from the most recent message you send to the bot
+- check installed agents and set a default engine
+
+to re-run onboarding (and overwrite config), use `takopi --onboard`.
+
+run your agent cli once interactively in the repo to trust the directory.
+
+## config
+
+global config `~/.takopi/takopi.toml`
+
+```toml
+default_engine = "codex"
+
+bot_token = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
+chat_id = 123456789
+
+[codex]
+# optional: profile from ~/.codex/config.toml
+profile = "takopi"
+
+[claude]
+model = "sonnet"
+# optional: defaults to ["Bash", "Read", "Edit", "Write"]
+allowed_tools = ["Bash", "Read", "Edit", "Write", "WebSearch"]
+dangerously_skip_permissions = false
+# uses subscription by default, override to use api billing
+use_api_billing = false
+
+[opencode]
+model = "claude-sonnet-4-20250514"
+
+[pi]
+model = "gpt-4.1"
+provider = "openai"
+# optional: additional CLI arguments
+extra_args = ["--no-color"]
+```
+
+## projects
+
+register the current repo as a project alias:
+
+```sh
+takopi init z80
+```
+
+`takopi init` writes the repo root to `[projects.<alias>].path`. if you run it inside a git worktree, it resolves the main checkout and records that path instead of the worktree.
+
+example:
+
+```toml
+default_project = "z80"
+
+[projects.z80]
+path = "~/dev/z80"
+worktrees_dir = ".worktrees"
+default_engine = "codex"
+worktree_base = "master"
+```
+
+## usage
+
+start takopi in the repo you want to work on:
+
+```sh
+cd ~/dev/your-repo
+takopi
+# or override the default engine for new threads:
+takopi claude
+takopi opencode
+takopi pi
+```
+
+resume lines always route to the matching engine; subcommands only override the default for new threads.
+
+send a message to the bot.
+
+start a new thread with a specific engine by prefixing your message with `/codex`, `/claude`, `/opencode`, or `/pi`.
+
+to continue a thread, reply to a bot message containing a resume line.
+you can also copy it to resume an interactive session in your terminal.
+
+to stop a run, reply to the progress message with `/cancel`.
+
+default: progress is silent, final answer is sent as a new message so you receive a notification, progress message is deleted.
+
+if you prefer no notifications, `--no-final-notify` edits the progress message into the final answer.
+
+## notes
+
+* the bot only responds to the configured `chat_id` (private or group)
+* run only one takopi instance per bot token: multiple instances will race telegram's `getUpdates` offsets and cause missed updates
+
+## development
+
+see [`docs/specification.md`](docs/specification.md) and [`docs/developing.md`](docs/developing.md).

takopi-0.9.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "takopi"
+authors = [{name = "banteg"}]
+version = "0.9.0"
+description = "Telegram bridge for Codex, Claude Code, and other agent CLIs."
+readme = "readme.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.14"
+dependencies = [
+  "anyio>=4.12.0",
+  "httpx>=0.28.1",
+  "markdown-it-py",
+  "msgspec>=0.20.0",
+  "questionary>=2.1.1",
+  "rich>=14.2.0",
+  "structlog>=25.5.0",
+  "sulguk>=0.11.1",
+  "typer>=0.21.0",
+]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/banteg/takopi"
+Repository = "https://github.com/banteg/takopi"
+Issues = "https://github.com/banteg/takopi/issues"
+
+[project.scripts]
+takopi = "takopi.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-anyio>=0.0.0",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.10",
+    "ty>=0.0.8",
+]
+
+[tool.pytest.ini_options]
+addopts = ["--cov=takopi", "--cov-report=term-missing", "--cov-fail-under=70"]
+testpaths = ["tests"]

takopi-0.9.0/readme.md

@@ -0,0 +1,138 @@
+# takopi
+
+🐙 *he just wants to help-pi*
+
+telegram bridge for codex, claude code, opencode, pi, and [other agents](docs/adding-a-runner.md). manage multiple projects and worktrees, stream progress, and resume sessions anywhere.
+
+## features
+
+projects and worktrees: register repos with `takopi init`, target them via `/project`, route to branches with `@branch`.
+
+stateless resume: continue a thread in the chat or pick up in the terminal.
+
+progress updates while agent runs (commands, tools, notes, file changes, elapsed time).
+
+robust markdown rendering of output with a lot of quality of life tweaks.
+
+parallel runs across threads, per thread queue support.
+
+`/cancel` a running task.
+
+## requirements
+
+- `uv` for installation (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
+- python 3.14+ (uv can install it: `uv python install 3.14`)
+- at least one engine installed:
+  - `codex` on PATH (`npm install -g @openai/codex` or `brew install codex`)
+  - `claude` on PATH (`npm install -g @anthropic-ai/claude-code`)
+  - `opencode` on PATH (`npm install -g opencode-ai@latest`)
+  - `pi` on PATH (`npm install -g @mariozechner/pi-coding-agent`)
+
+## install
+
+- `uv python install 3.14`
+- `uv tool install -U takopi` to install as `takopi`
+- or try it with `uvx takopi@latest`
+
+## setup
+
+run `takopi` and follow the interactive prompts. it will:
+
+- help you create a bot token (via @BotFather)
+- capture your `chat_id` from the most recent message you send to the bot
+- check installed agents and set a default engine
+
+to re-run onboarding (and overwrite config), use `takopi --onboard`.
+
+run your agent cli once interactively in the repo to trust the directory.
+
+## config
+
+global config `~/.takopi/takopi.toml`
+
+```toml
+default_engine = "codex"
+
+bot_token = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
+chat_id = 123456789
+
+[codex]
+# optional: profile from ~/.codex/config.toml
+profile = "takopi"
+
+[claude]
+model = "sonnet"
+# optional: defaults to ["Bash", "Read", "Edit", "Write"]
+allowed_tools = ["Bash", "Read", "Edit", "Write", "WebSearch"]
+dangerously_skip_permissions = false
+# uses subscription by default, override to use api billing
+use_api_billing = false
+
+[opencode]
+model = "claude-sonnet-4-20250514"
+
+[pi]
+model = "gpt-4.1"
+provider = "openai"
+# optional: additional CLI arguments
+extra_args = ["--no-color"]
+```
+
+## projects
+
+register the current repo as a project alias:
+
+```sh
+takopi init z80
+```
+
+`takopi init` writes the repo root to `[projects.<alias>].path`. if you run it inside a git worktree, it resolves the main checkout and records that path instead of the worktree.
+
+example:
+
+```toml
+default_project = "z80"
+
+[projects.z80]
+path = "~/dev/z80"
+worktrees_dir = ".worktrees"
+default_engine = "codex"
+worktree_base = "master"
+```
+
+## usage
+
+start takopi in the repo you want to work on:
+
+```sh
+cd ~/dev/your-repo
+takopi
+# or override the default engine for new threads:
+takopi claude
+takopi opencode
+takopi pi
+```
+
+resume lines always route to the matching engine; subcommands only override the default for new threads.
+
+send a message to the bot.
+
+start a new thread with a specific engine by prefixing your message with `/codex`, `/claude`, `/opencode`, or `/pi`.
+
+to continue a thread, reply to a bot message containing a resume line.
+you can also copy it to resume an interactive session in your terminal.
+
+to stop a run, reply to the progress message with `/cancel`.
+
+default: progress is silent, final answer is sent as a new message so you receive a notification, progress message is deleted.
+
+if you prefer no notifications, `--no-final-notify` edits the progress message into the final answer.
+
+## notes
+
+* the bot only responds to the configured `chat_id` (private or group)
+* run only one takopi instance per bot token: multiple instances will race telegram's `getUpdates` offsets and cause missed updates
+
+## development
+
+see [`docs/specification.md`](docs/specification.md) and [`docs/developing.md`](docs/developing.md).

takopi-0.9.0/src/takopi/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.9.0"

takopi-0.9.0/src/takopi/backends.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .runner import Runner
+
+EngineConfig = dict[str, Any]
+
+
+@dataclass(frozen=True, slots=True)
+class SetupIssue:
+    title: str
+    lines: tuple[str, ...]
+
+
+@dataclass(frozen=True, slots=True)
+class EngineBackend:
+    id: str
+    build_runner: Callable[[EngineConfig, Path], Runner]
+    cli_cmd: str | None = None
+    install_cmd: str | None = None

takopi-0.9.0/src/takopi/backends_helpers.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from .backends import SetupIssue
+
+
+def install_issue(cmd: str, install_cmd: str | None) -> SetupIssue:
+    if install_cmd:
+        lines = (f"   [dim]$[/] {install_cmd}",)
+    else:
+        lines = ("   [dim]See engine setup docs for install instructions.[/]",)
+    return SetupIssue(
+        f"install {cmd}",
+        lines,
+    )