# 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.

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 init` in 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+) or `bun:sqlite` with 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 dashboard` launches 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.

## 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

## Integrations
Claude Code, OpenCode, SQLite, PostgreSQL, MySQL, Jira (planned), Linear (planned), GitHub Issues (planned), Node.js, Bun

## Platforms
WEB, API, CLI

## Pricing
Open Source

## Version
1.1.1

## Links
- Website: https://ahk.cardor.dev
- Documentation: https://github.com/enmanuelmag/agent-harness-kit#readme
- Repository: https://github.com/enmanuelmag/agent-harness-kit
- EveryDev.ai: https://www.everydev.ai/tools/agent-harness-kit