agent-harness-kit
Auto-scaffold a multi-agent harness for any repo with SQLite state, MCP tools, health checks, and coordination rules — automatically generated via CLI.
At a Glance
About agent-harness-kit
agent-harness-kit (ahk) is a CLI tool that auto-scaffolds a complete multi-agent coordination harness for any code repository. With a single npx command, it generates AGENTS.md, typed config files, database schemas, per-agent instruction files, and a health script. It supports SQLite (zero native deps), PostgreSQL, and MySQL out of the box, and ships with a built-in MCP server exposing 12 tools for task management, action tracking, and doc search.
- One-command setup — run
npx @cardor/agent-harness-kit initin any project root; answer prompts or pass flags to skip them entirely. - Four specialized agents — Lead (orchestrator), Explorer (read-only), Builder (writes src/), and Reviewer (gatekeeper) coordinate automatically with explicit permission boundaries.
- SQLite by default — uses
node:sqlite(Node 22+) orbun:sqlitewith zero native dependencies; switch to PostgreSQL or MySQL with one config line. - 12 MCP tools — agents call
tasks.getList,tasks.claim,tasks.add,actions.start,actions.write,docs.search, and more instead of reading files directly. - Real-time dashboard —
ahk dashboardlaunches a web UI with WebSocket updates showing agent activity, file touches, and tool calls. - Multi-provider support — works with Claude Code and OpenCode; additional providers on the roadmap.
- Task adapters — local task list supported now; Jira, Linear, and GitHub Issues adapters planned.
- TypeScript config — full type safety on all generated configuration files.
- Global installation — install once and share a single harness across all projects.
- MIT License — open source, free to use and modify.
Community Discussions
Be the first to start a conversation about agent-harness-kit
Share your experience with agent-harness-kit, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
Fully free and open source under the MIT License. All features included.
- SQLite by default — zero native deps (Node 22+ or Bun)
- PostgreSQL + MySQL support
- 4 specialized base agents + custom agents
- Dashboard for monitoring agent activity in real time
- Built-in MCP server with 12 tools
Capabilities
Key Features
- Auto-scaffold multi-agent harness via CLI
- SQLite, PostgreSQL, and MySQL support
- Built-in MCP server with 12 tools
- Four specialized base agents (Lead, Explorer, Builder, Reviewer)
- Real-time dashboard with WebSocket updates
- Task management via MCP (claim, add, update, acceptance criteria)
- Action tracking with file and tool registration
- TypeScript config with full type safety
- Global installation mode
- Watch mode for ahk build
- ahk reset command for clean slate
- Input validation on all CLI prompts (Valibot)
- Multi-provider: Claude Code + OpenCode
- Markdown fallback (no MCP needed)
- Dry-run preview for sync changes
