Reference

Untether reads configuration from ~/.untether/untether.toml. · 9 min read

This page documents how Untether resolves run context (project, worktree/branch, engine) from messages. For step-by-step usage, see Projects and Worktrees. · 4 min read

Untether runs two isolated instances on lba-1: production (PyPI release) and dev (local editable source). They use separate Telegram bots, separate configs, ... · 3 min read

Untether supports a small set of environment variables for logging and runtime behavior. · 2 min read

Structured, repeatable integration test process run against @untether_dev_bot before every release. Tests exercise all 6 engines across the full feature surf... · 18 min read

Untether’s public plugin API is exported from: · 5 min read

Community and third-party plugins that extend untether. · 1 min read

Below is the implementation spec for the AMP CLI (Sourcegraph) runner shipped in Untether. · 3 min read

amp -x --stream-json writes one JSON object per line (JSONL) using a Claude Code-compatible protocol with a type field discriminator. · 1 min read

This document describes how the AMP runner translates AMP CLI --stream-json JSONL events into Untether events. · 4 min read

Below is a concrete implementation spec for the Anthropic Claude Code (“claude” CLI / Agent SDK runtime) runner shipped in Untether (v0.3.0). · 12 min read

claude -p --output-format stream-json --input-format stream-json --verbose writes one JSON object per line (JSONL) with a required type field. · 2 min read

This document describes how the Claude Code runner translates Claude Code CLI JSONL events into Untether events. · 6 min read

codex exec --json writes one JSON object per line (JSONL) to stdout. Each line is a top-level thread event with a type field. · 5 min read

This document describes how Codex exec --json events are translated to Untether's normalized event model. · 7 min read

Below is the implementation spec for the Gemini CLI runner shipped in Untether. · 3 min read

gemini -p --output-format stream-json writes one JSON object per line (JSONL) with a required type field. · 1 min read

This document describes how the Gemini runner translates Gemini CLI --output-format stream-json JSONL events into Untether events. · 3 min read

This runner integrates with the OpenCode CLI. Shipped in Untether v0.5.0. · 1 min read

opencode run --format json writes one JSON object per line (JSONL) to stdout. Each line has a type field indicating the event type. · 3 min read

This document describes how OpenCode JSON events are translated to Untether's normalized event model. · 2 min read

Below is a concrete implementation spec for the Pi (pi-coding-agent CLI) runner shipped in Untether (v0.5.0). · 3 min read

pi --print --mode json writes one JSON object per line (JSONL) with a required type field. These are AgentSessionEvent objects from @mariozechner/pi-agent-core. · 1 min read

This document describes how the Pi runner translates Pi CLI --mode json JSONL events into Untether events. · 4 min read

This document is normative. The words MUST, SHOULD, and MAY express requirements. · 15 min read

TelegramClient is the single transport for Telegram writes. It owns a TelegramOutbox that serializes send/edit/delete operations, applies coalescing, and enf... · 7 min read

The trigger system lets external events start agent runs automatically. Webhooks accept HTTP POST requests (GitHub pushes, Slack alerts, PagerDuty incidents)... · 7 min read