AI Harness

English · Tiếng Việt · 简体中文 · Español

Reusable agent workflows for software development: Requirements → Design → Code → Test → Review.

Give an idea, existing docs or a change request to your AI coding tool. Harness helps it inspect the project, clarify open decisions, implement accepted scope and maintain relevant specs/docs. Use only the roles and skills the task needs.

Works with any project through Core workflows. Optional stack support: Spring Boot, React/Next.js, React Native, Python, Astro and Kubernetes. Stack selection does not choose infrastructure or architecture.

Quick start

Requires Node.js 22+ and your AI coding tool. Run in your project root:

npx --yes @manhd_d/ai-harness init --host codex

Set --host to codex, claude-code, cursor, copilot, gemini-cli or kiro. In your first AI session, invoke harness-start if the host exposes it, or send:

Read .agents/skills/harness-start/SKILL.md and follow it for this project. My task: [task].

The agent inspects the project, asks only missing questions and saves context. Kiro exposes /harness-start; native discovery varies by client. Host guides. npx does not create a global command; use npx --yes @manhd_d/ai-harness check to check integrity.

pip / restricted networks (included in the next reviewed release; PyPI publication requires maintainer setup):

python -m pip install manhd-ai-harness
aih init --host codex

Requires Python 3.9+ and Node.js 22+. The wheel bundles the same JavaScript CLI and assets; it never calls npm or npx. Offline: python -m pip install --no-index --no-deps /path/to/package.whl. Offline install & update · Settings & backup.

Use init --detect for stack detection. Your host runs tests and controls tools, delegation and permissions. Harness owns workflow contracts and evidence formats; hosts or separate drivers execute them. Workflow contracts · Conformance runner.

Where it runs

| AI tool | Environment | Install the tool | Harness setup | | --- | --- | --- | --- | | Codex | CLI, IDE or connected cloud workspace | Install | Guide | | Claude Code | Project terminal | Install | Guide | | Cursor | IDE Agent | Install | Guide | | GitHub Copilot | IDE Agent or CLI | Install | Guide | | Gemini CLI | Project terminal | Install | Guide | | Kiro | IDE, CLI or connected Web workspace | Install | Guide |

Local/cloud execution and external inputs depend on the host's actual access. MCP/connector/API connections can supply docs, designs, tickets and evidence under project source policies.

Getting started · Docs & examples · Input/output · Agent configuration · Continuous development

Contributing · Harness maintenance · MIT