Maturity-aware harness manager for local AI coding agents (Claude Code, Codex CLI, Copilot CLI, Cursor). Audit, init, and refresh AGENTS.md / GROUNDING.md / CI / sandbox at the right S0–S3 stage; ships an installable skill.
Project description
local-agent-harness
Maturity-aware harness manager for local AI coding agents (Claude Code, Codex CLI, GitHub Copilot CLI, Cursor).
local-agent-harness makes a repository ready for AI-agent-assisted
development from two directions:
- Make the agent work better. Generate
AGENTS.md/GROUNDING.md, per-runtime overlays (CLAUDE.md,.codex/config,.github/copilot-cli.md,.cursor/rules), tool DAGs, permission ladders, governed memory, and cost/context budgets. - Make the repository ready. Render sandbox/devcontainer,
.pre-commit-config.yaml, verify CI, governance CI, secrets/SAST/dep scans, and a machine-readable AI-readiness score.
The harness evolves with the repo. A blank S0 skeleton receives a minimal kit; a mature S3 codebase gets the full set of governance gates.
Install
pipx install local-agent-harness
local-agent-harness setup # install the bundled skill into ~/.claude, ~/.copilot, ~/.codex
setup only installs into agent skill roots whose parent directory
already exists. Override with --target PATH (repeatable) to install
into project-local locations like .github/skills/.
Usage
local-agent-harness assess # detect maturity stage + AI-readiness score
local-agent-harness check # audit manifests for drift (read-only)
local-agent-harness init --runtime claude-code --runtime copilot-cli
local-agent-harness refresh --apply # rewrite stale manifests (backups written)
local-agent-harness report --out .agent/readiness.md
local-agent-harness validate # regression + redaction smoke checks
Three modes:
| Mode | Writes? | Use when |
|---|---|---|
check |
no | Audit-only — CI gate or quick diagnosis. |
init |
yes | Render missing manifests; never overwrites. |
refresh |
yes (with --apply) |
Back up + rewrite stale or relaxed manifests. |
Stages (S0 → S3)
| Stage | Repo signal | Default kit |
|---|---|---|
| S0 | empty / no source / no tests / no CI | AGENTS.md, GROUNDING.md, plan.md |
| S1 | source + tests OR CI | + pre-commit, devcontainer, verify CI |
| S2 | source + tests + CI | + governance CI, redaction smoke |
| S3 | + tags/releases | + readiness gate, no-regression check |
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file local_agent_harness-0.1.0.tar.gz.
File metadata
- Download URL: local_agent_harness-0.1.0.tar.gz
- Upload date:
- Size: 31.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c1a506bb434aef4ce22c7ffa9c87ed371ca98d6da148a6814a4a776a0f1274f
|
|
| MD5 |
a559f5c62ab19d38129a2289f044df54
|
|
| BLAKE2b-256 |
9f0424a0f6b41af83c7c23823086c7c280e0fb5b2620139cf9205e014e3dc827
|
File details
Details for the file local_agent_harness-0.1.0-py3-none-any.whl.
File metadata
- Download URL: local_agent_harness-0.1.0-py3-none-any.whl
- Upload date:
- Size: 52.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3dc911482b9d157ca65da133836ca481cf972e9c6c4d04d3ab5a8350a2f33536
|
|
| MD5 |
389a868502fb36ce5765772f2e142205
|
|
| BLAKE2b-256 |
3104aed05015f1c2236a1e7a93deaa0c7ef2ae843695e1ea48d942ca8b8ea254
|
