
Agent Harness Kit
Structured multi-agent workflows for your codebase
Details
- Follow on
- @enmanuelmagLinkedIn
- Categories
- Developer ToolsOpen Source
- Target Audience
- DevelopersAI EngineersSoftware Developers
- Pricing
- Free
About Agent Harness Kit
`agent-harness-kit` (ahk) is a thin CLI + library you drop into any repo to give your AI agents structure. It scaffolds a 4-role workflow (Lead → Explorer → Builder → Reviewer), a local SQLite task backlog with atomic claiming, lifecycle health gates, and a full audit trail — all without touching any cloud service or requiring API keys. Why: Every time I handed a task to Claude Code or OpenCode, the agent would just roam. It had no memory of what it already explored, no way to coordinate with a second agent, and no gate to check if the codebase was even in a healthy state before it started writing. I wanted something closer to how senior engineers actually work: a clear role per agent, a shared task list, and a mandatory verification step before anything is marked done. The architecture is deliberately boring: one `agent.harness.ts` config file, a `.harness/` directory with a SQLite DB (using Node ≥ 22's built-in `node:sqlite` — zero native deps), and markdown agent definitions your LLM reads at session start. It works with Claude Code, OpenCode, Cursor, or any tool that can read files. ``` npx ahk init # scaffold the harness into your repo npx ahk health # verify the environment before agents start npx ahk status # see task backlog and agent activity ``` **Link:** https://github.com/enmanuelmag/agent-harness-kit Would love to hear your thoughts — especially if you've tried other approaches to multi-agent coordination!
Product Insights
Agent Harness Kit provides a structured multi-agent workflow for local codebases through a CLI that manages tasks via SQLite without cloud dependencies. It coordinates Lead, Explorer, Builder, and Reviewer roles to ensure systematic task execution and code health.
- Operates entirely locally using a SQLite task backlog with zero required API keys or cloud services.
- Implements a predefined four-role workflow to coordinate specialized agent activities.
- Includes built-in health gates to verify codebase state before and after agent interactions.
- Compatible with major AI tools including Claude Code, OpenCode, and Cursor via a standardized config file.
Ideal for: Developers and AI Engineers who need to organize multi-agent task execution and maintain an audit trail within their local repositories.
Screenshots
Reviews (2)
Average 5.0 out of 5
Based on 2 reviews
Excellent toolkit for building structured multi-agent workflows for codebases!



Comments (1)
I got tired of AI agents roaming my codebase. So I built a harness layer. Drop it into any project with, and your agents get a task backlog, defined roles, a health gate, dashboard to trace everything