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 at the same time without duplicating effort: 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 and missed deadlines surface on their own, and handoffs stay readable across sessions. 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 work is claimed once instead of duplicated
- 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 - A regression suite that pins each known bug class so it cannot return quietly
Status
Active. Used here to coordinate every multi-session project on this site.