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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

local_agent_harness-0.3.12.tar.gz (46.5 kB view details)

Uploaded May 9, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

local_agent_harness-0.3.12-py3-none-any.whl (71.3 kB view details)

Uploaded May 9, 2026 Python 3

File details

Details for the file local_agent_harness-0.3.12.tar.gz.

File metadata

Download URL: local_agent_harness-0.3.12.tar.gz
Upload date: May 9, 2026
Size: 46.5 kB
Tags: Source
Uploaded using 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}

File hashes

Hashes for local_agent_harness-0.3.12.tar.gz
Algorithm	Hash digest
SHA256	`87f5fa4390ca8c2746942cc78557d064bd5d005cb232a2c0d95c9ae10bea440c`
MD5	`d66392d62ce63a36ab4de778a6a3f709`
BLAKE2b-256	`47e6912e68b6552f94426104e71d22072a7c3b87590fec305dc345e83b279262`

See more details on using hashes here.

File details

Details for the file local_agent_harness-0.3.12-py3-none-any.whl.

File metadata

Download URL: local_agent_harness-0.3.12-py3-none-any.whl
Upload date: May 9, 2026
Size: 71.3 kB
Tags: Python 3
Uploaded using 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}

File hashes

Hashes for local_agent_harness-0.3.12-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3e405520977d67e5242e12354dcb51e38d50df382b325e0f1f1b1ef8dd4c4fc2`
MD5	`b7a7c8c4c0faa2a4f378e11a29500c71`
BLAKE2b-256	`acd2ae4c11fe5c074151412ee3d3423f0fc784767e728f9054e2f9d021c331cb`