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

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

This version

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.1.tar.gz (42.2 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.1-py3-none-any.whl (66.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.1.tar.gz
  • Upload date:
  • Size: 42.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","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.1.tar.gz
Algorithm Hash digest
SHA256 353d5142803cb82ad0ba947442de39193e365d5f402751ee06ef7b643e8fb60b
MD5 59d9765f4c2eea3d83202246c1e6ca61
BLAKE2b-256 327a9eda7ef57f58794560bc4a8476855811673b8cb0a75eef3d43051aae9ea9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 66.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c4daa77dced54f223652a5c8652c64a2ba9e240e6bb7b585e09392d4f6264207
MD5 3b137f9137ece000cc0f839f24540c1d
BLAKE2b-256 70390c31eaa625ce103c89586e73871c3ea439448bfe9cdea22bdb3f38461fbc

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