Metadata-Version: 2.5
Name: agent-harness-kit-cli
Version: 0.7.1
Summary: Artifact-driven development harness for coding agents
Project-URL: Homepage, https://github.com/Eduardo-Salvador/Agent-Harness-Kit
Project-URL: Repository, https://github.com/Eduardo-Salvador/Agent-Harness-Kit
Project-URL: Issues, https://github.com/Eduardo-Salvador/Agent-Harness-Kit/issues
Author: Eduardo Salvador
License: MIT License
        
        Copyright (c) 2026 Agent Harness Kit contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: agents,claude,codex,developer-tools,harness
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Agent Harness Kit

Agent Harness Kit is a local execution-governance layer for coding agents. It gives Codex and Claude Code durable project context, adaptive workflow selection, dependency-aware execution, ownership leases, proportional verification, and inspectable completion.

![Agent Harness Kit](https://raw.githubusercontent.com/Eduardo-Salvador/Agent-Harness-Kit/v0.7.1/docs/assets/agent-harness-kit-banner.svg)

## Install

```bash
uv tool install agent-harness-kit-cli
```

For an existing installation, run `uv tool upgrade agent-harness-kit-cli` and verify `agent-harness --version`; repeating `uv tool install` does not upgrade an already installed tool.

Or install from the same PyPI release with `pipx` or plain `pip`, including from the integrated terminal in VS Code:

```bash
pipx install agent-harness-kit-cli
python -m pip install agent-harness-kit-cli
```

On Windows, `py -m pip install agent-harness-kit-cli` is also supported. Prefer a virtual environment with plain `pip`.

Open a terminal inside a project and run:

```bash
agent-harness install
```

The recommended `core` profile is installed by default. Use `--dry-run` to preview or `--profile core-learning` to include optional, consented project-learning support.

The installer creates a contained `agent-harness-kit/` directory **plus root `AGENTS.md` and `CLAUDE.md` entrypoints**. Missing root files are created; existing instructions are preserved outside one managed bridge block. Open a new agent context at the project root after installation, then use `agent-harness doctor` to verify the entrypoints.

## What it does

- four execution lanes (`direct-trivial`, `vibe`, `graph-only`, `full-harness`) independent from `none|light|full` assurance;
- evidence-first resume: probe current repository/runtime/check state, then read durable artifacts only to fill gaps;
- adaptive first-run project-shape discovery: reuse approved evidence, resolve architecture and folder organization before planning, and ask about optional coding conventions only when they are not already established;
- executable preflight for declared paths, scripts, environment names, commands, validator, browser/sandbox requirements, and worker capacity;
- `PENDING.md` for human decisions and macro gaps;
- `TASK-GRAPH.md` for dependencies, leases, progress, and execution;
- compact same-context specs and consumer-driven handoff/review artifacts;
- planned units targeting 15–30 active minutes, with justified exceptions;
- focused-first verification that climbs through workspace, integration, checkpoint, and delivery only as needed;
- scoped `read_set`, exclusive `write_set`, related `impact_set`, and source provenance to avoid unnecessary repository rescans;
- maximum-cardinality collision-free scheduling for hosts with proven parallel capacity;
- atomic compare-and-swap graph transitions, hash-chained events, append-only run metrics, and lighter-lane suggestions;
- bounded native Codex dispatch packets and fresh-context review when the host provides those capabilities;
- hackathon mode for compressed discovery and demo-first MVP delivery;
- a validator covering source, packaged profiles, and installed-host behavior.

The CLI performs deterministic installation, inspection, routing, preflight, scheduling, state transitions, metrics, and dispatch-packet operations. Capable agent hosts perform the actual coding and agent creation. The Kit has no unattended background daemon and does not lock operating-system files, merge branches, or deploy software on its own.

Documentation, source, audio overview, and examples are available in the [GitHub repository](https://github.com/Eduardo-Salvador/Agent-Harness-Kit).
