Metadata-Version: 2.4
Name: local-agent-harness
Version: 0.3.2
Summary: 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.
Keywords: ai-agents,claude-code,codex-cli,copilot-cli,github-actions,agents-md,harness,skill,ai-readiness
Author: Grammy Jiang
Author-email: Grammy Jiang <grammy.jiang@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Typing :: Typed
Requires-Dist: typer>=0.12,<1
Requires-Dist: pytest>=8.0 ; extra == 'dev'
Requires-Dist: pytest-cov>=5.0 ; extra == 'dev'
Requires-Dist: ruff>=0.6 ; extra == 'dev'
Requires-Dist: mypy>=1.10 ; extra == 'dev'
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/grammy-jiang/local-agent-harness
Project-URL: Repository, https://github.com/grammy-jiang/local-agent-harness
Project-URL: Issues, https://github.com/grammy-jiang/local-agent-harness/issues
Provides-Extra: dev
Description-Content-Type: text/markdown

# 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

```bash
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

```bash
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
