Tether

Tether

Tether is a local CLI orchestration layer that makes autonomous coding agents more reliable. It wraps any coding agent (opencode, pi, aider, claude-code, or an arbitrary CLI) in a structured control loop:

**Mission Contract → Planning → Execution → Verification → Recovery → Rollback/Audit**

The core loop is **agent-agnostic**: all agent-specific behavior lives behind a single `AgentAdapter` interface. Tether never depends on a specific vendor CLI to function — the built-in `MockAdapter` is fully deterministic and works offline.

Install & run

Requires Python 3.11+ and git (for checkpoint/rollback).

cd tether
python3 -m venv .venv && .venv/bin/pip install -e .
# entrypoint:
.venv/bin/tether --help
# or without install:
.venv/bin/python -m tether --help

Quick tour

tether init                                        # write a starter tether.yaml
tether validate-config                             # validate project config
tether validate-mission examples/hello-success.yaml
tether adapters list                               # availability, capabilities + verified/experimental status
tether adapters conformance mock                    # behavioral conformance battery (PASS/FAIL)
tether run examples/hello-success.yaml --adapter mock --project-dir /some/project
tether report                          # print report.json of a past session
tether sessions list                               # list past sessions
tether sessions show         # human-readable session summary
tether sessions stats                              # cross-session analytics (--json for machines)
tether sessions clean --older-than 30d             # preview old-session cleanup (nothing deleted)
tether sessions clean --older-than 30d --confirm   # delete session dirs older than 30 days
tether diff                            # files changed during a session
tether diff  --patch                   # saved patch.d