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. The harness enforces a shared lifecycle: plan, approve, implement, report. Stale tasks, missed deadlines, and unread handoffs are handled automatically. No one has to police the state.
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 here to coordinate every multi-session project on this site.