Harness Supervisor — Git skill for Claude Code

harness-supervisor

Reliable coordination for Codex and Claude Code.

`harness-supervisor` gives an agent team a shared, Git-aware way to define work, reserve local resources, retain verification evidence, and land a completed change safely. It keeps durable decisions in Git and run-specific state local to the checkout.


The supervisor turns one ready task into visible, verifiable parallel work — with the live agent tree keeping every session in view.

Regenerate this documentation-only animation with [`docs/generate-readme-demo.mjs`](docs/generate-readme-demo.mjs).

What you get

Need	Tool
A clear, reviewable task before execution	agent-task
One view of worktree state and safe handover	agent-state
Exclusive ports and other host resources	agent-lease
Evidence tied to exact task and Git revisions	agent-verify
Safe, serialized integration	agent-merge-lock
Installation and runtime diagnostics	agent-doctor

Install

From this checkout, link the harness into the repository you want to manage:

./link.sh /absolute/path/to/repository
./harness/bin/agent-doctor /absolute/path/to/repository --json

The installer is repeatable for links it owns, preserves an existing `CLAUDE.md`, and refuses foreign paths. Add the relevant guidance from [AGENTS.supervisor.md](harness/AGENTS.supervisor.md) to the target repository's own `AGENTS.md`. If this checkout moves, inspect the diagnostic output and use:

./link.sh --relink-from /old/absolute/harness/checkout /absolute/path/to/repository

`agent-doctor` only reports what it finds. It never changes project or user settings.

Typical workflow

Create a task contract, review it, and give a fresh execution session its exact revision:

agent-task stamp docs/tasks/