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

This version

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.3.tar.gz (41.9 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.3-py3-none-any.whl (65.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.3.tar.gz
  • Upload date:
  • Size: 41.9 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.3.tar.gz
Algorithm Hash digest
SHA256 c886e669976db5f62f40ff6fb218c1fd5f018f543ec518ec4a99d16e8458eb7e
MD5 5710ca20b32e8dc88ea6e7ba70193e35
BLAKE2b-256 152654cb50290107b4ff554ff45509943a621d601ec57d11aca00d3ca89922d2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 65.6 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c658f0c4a5c92d96dd901db7cd61a0a297f5f79803b6e26d048bb580d4ffb671
MD5 02a4d9c650f9143b24dfb4bd0779d790
BLAKE2b-256 4b9e78460784971e7d4b9c739a0491a9b666440e4f774e171a38482f4136b7d7

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