Maturity-aware harness manager for local AI coding agents (Claude Code, Codex CLI, Copilot CLI). Audit, init, and refresh AGENTS.md / GROUNDING.md / CI on GitHub Actions / sandbox at the right S0–S3 stage; ships an installable skill.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for grammy.jiang from gravatar.com grammy.jiang

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Grammy Jiang
  • Tags ai-agents , claude-code , codex-cli , copilot-cli , github-actions , agents-md , harness , skill , ai-readiness
  • Requires: Python >=3.11
  • Provides-Extra: dev
Classifiers
Report project as malware

Project description

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:

  1. 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.
  2. 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

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for grammy.jiang from gravatar.com grammy.jiang

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Grammy Jiang
  • Tags ai-agents , claude-code , codex-cli , copilot-cli , github-actions , agents-md , harness , skill , ai-readiness
  • Requires: Python >=3.11
  • Provides-Extra: dev
Classifiers

Release history Release notifications | RSS feed

This version

0.3.12

0.3.11

0.3.10

0.3.9

0.3.8

0.3.7

0.3.6

0.3.5

0.3.4

0.3.3

0.3.2

0.3.1

0.3.0

0.2.1

0.2.0

0.1.0

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 Source

Built Distribution

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

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

Uploaded 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:
  • 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:
  • 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

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page