local-agent-harness
Maturity-aware harness manager for local AI coding agents (Claude Code, Codex CLI, GitHub Copilot CLI).
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), 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 --runtime codex-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
1 maintainer
Metadata
1 maintainer
Release files for local-agent-harness 0.3.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| local_agent_harness-0.3.12.tar.gz | 46.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| local_agent_harness-0.3.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 117.8 kB
Release files / local_agent_harness-0.3.12.tar.gz
| Download URL | local_agent_harness-0.3.12.tar.gz |
|---|---|
| Size | 46.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
87f5fa4390ca8c2746942cc78557d064bd5d005cb232a2c0d95c9ae10bea440c
|
|
BLAKE2b-256 checksum How to use checksums |
47e6912e68b6552f94426104e71d22072a7c3b87590fec305dc345e83b279262
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / local_agent_harness-0.3.12-py3-none-any.whl
| Download URL | local_agent_harness-0.3.12-py3-none-any.whl |
|---|---|
| Size | 71.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e405520977d67e5242e12354dcb51e38d50df382b325e0f1f1b1ef8dd4c4fc2
|
|
BLAKE2b-256 checksum How to use checksums |
acd2ae4c11fe5c074151412ee3d3423f0fc784767e728f9054e2f9d021c331cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
