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

This version

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.6.tar.gz (45.1 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.6-py3-none-any.whl (69.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.6.tar.gz
  • Upload date:
  • Size: 45.1 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.6.tar.gz
Algorithm Hash digest
SHA256 2bcafb8ed2631e9c252dc6bb22358ab9c497f6446c799f5699d09a581b831d14
MD5 fb791b2279c41612a4bc14bdafe6413e
BLAKE2b-256 671e8d4c7d5b9a77b4b2d4f44a4c7ce81ffc372ebd1d08996a816c44ff341f7d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.6-py3-none-any.whl
  • Upload date:
  • Size: 69.7 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 0562b39d2dfd42b8018a4e1211b4dc6ab14b60e96fbc56fe9221cf92b835edbb
MD5 317d23e95e676c8aec570a0badaa8a85
BLAKE2b-256 54134aab4f258fae37572720171f9c5059d43760ceb921d16e8c7b297e7ef74a

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