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

This version

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.7.tar.gz
  • Upload date:
  • Size: 45.0 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.7.tar.gz
Algorithm Hash digest
SHA256 78241c82e1d6fcfb0482cf2261c0094b0d70f25d281653583f5d9fa2beaaa9e0
MD5 f44fed15359108566972d020d133c4da
BLAKE2b-256 f7cf34135c3357bda89ff99cede5fbc8b125878ce150cf90317d84e9e3a6c6fa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: local_agent_harness-0.3.7-py3-none-any.whl
  • Upload date:
  • Size: 69.7 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 194abc86c95b1e29d027ec3c2130ba631f3c845991197c1981f671202033fb89
MD5 aa6cc4261951628133d03971f48eb024
BLAKE2b-256 fd5d572dc9bc7997c8b61297f76ad4446296953c491d736590a3b9c4e238845e

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