tomwolfe

Tether — Development skill for Claude Code

Development community

a local CLI orchestration layer that makes autonomous coding agents more reliable.

How to install Tether

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tomwolfe/tether and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tether does

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

Alternatives in Development

CORS — Scan an endpoint for CORS misconfiguration — arbitrary-origin reflection, null-origin trust, credential exposu 4.5k ★
Ralphy — My Ralph Wiggum setup, an autonomous bash script that runs Claude Code, Codex, OpenCode, Cursor agent, Qwen & 2.8k ★
OpenSquirrel — For people who get distracted by agents 1.3k ★

README

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