Superharness
Multi-agent task coordination for Claude Code, Codex CLI, Gemini CLI, and OpenCode — a shared contract layer that keeps AI coding assistants from stepping on each other.
Superharness is the session and handoff layer for multi-agent development. It lets Claude Code, Codex CLI, Gemini CLI, and OpenCode work on the same project simultaneously without conflicts: a shared SQLite-backed task contract, queue-based delegation, lifecycle rules, and a structured handoff protocol so work survives across sessions and agents.
The thesis is coordination through constraint. Each agent operates independently, but the harness enforces a shared lifecycle — plan, approve, implement, report — and auto-manages stale tasks, deadlines, and handoffs without requiring a human to police every state transition.
The alias is shux. You install it once; every project gets its own .superharness/ directory.
What it does
- Shared task contract (SQLite) so agents never overlap on the same work
- Queue-based delegation: an agent picks up work, implements, reports — then stops
- Six auto-mode lifecycle rules: stale in-progress tasks escalate, deadlines auto-fail, consensus discussions auto-close
- FTS5 recall across all handoffs and ledger entries —
shux recall <keywords>searches the full session history - Dashboard UI at
localhost:8787for live visibility without interrupting agents - 151 tests preventing 9 known bug classes from recurring
Status
Active. v1.44.21. Used in the workshop to coordinate every multi-session project on this site.