{"id":49649845,"url":"https://github.com/grammy-jiang/local-agent-harness","last_synced_at":"2026-05-12T03:00:58.937Z","repository":{"id":355946428,"uuid":"1230353511","full_name":"grammy-jiang/local-agent-harness","owner":"grammy-jiang","description":"Maturity-aware harness manager for local AI coding agents (Claude Code, Codex CLI, Copilot CLI, Cursor). Audit, init, and refresh AGENTS.md / GROUNDING.md / CI / sandbox at the right stage.","archived":false,"fork":false,"pushed_at":"2026-05-09T00:26:45.000Z","size":234,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T01:02:50.020Z","etag":null,"topics":["agents-md","ai-agents","claude-code","codex-cli","copilot-cli","harness","skill"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grammy-jiang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-05T23:15:19.000Z","updated_at":"2026-05-09T00:26:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/grammy-jiang/local-agent-harness","commit_stats":null,"previous_names":["grammy-jiang/local-agent-harness"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/grammy-jiang/local-agent-harness","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grammy-jiang%2Flocal-agent-harness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grammy-jiang%2Flocal-agent-harness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grammy-jiang%2Flocal-agent-harness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grammy-jiang%2Flocal-agent-harness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grammy-jiang","download_url":"https://codeload.github.com/grammy-jiang/local-agent-harness/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grammy-jiang%2Flocal-agent-harness/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32921614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"online","status_checked_at":"2026-05-12T02:00:06.338Z","response_time":102,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents-md","ai-agents","claude-code","codex-cli","copilot-cli","harness","skill"],"created_at":"2026-05-06T04:07:58.404Z","updated_at":"2026-05-12T03:00:58.931Z","avatar_url":"https://github.com/grammy-jiang.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# local-agent-harness\n\nMaturity-aware harness manager for local AI coding agents (Claude Code,\nCodex CLI, GitHub Copilot CLI, Cursor).\n\n`local-agent-harness` makes a repository ready for AI-agent-assisted\ndevelopment from two directions:\n\n1. **Make the agent work better.** Generate `AGENTS.md` / `GROUNDING.md`,\n   per-runtime overlays (`CLAUDE.md`, `.codex/config`,\n   `.github/copilot-cli.md`, `.cursor/rules`), tool DAGs, permission\n   ladders, governed memory, and cost/context budgets.\n2. **Make the repository ready.** Render sandbox/devcontainer,\n   `.pre-commit-config.yaml`, verify CI, governance CI, secrets/SAST/dep\n   scans, and a machine-readable AI-readiness score.\n\nThe harness *evolves with the repo*. A blank S0 skeleton receives a\nminimal kit; a mature S3 codebase gets the full set of governance gates.\n\n## Install\n\n```bash\npipx install local-agent-harness\nlocal-agent-harness setup        # install the bundled skill into ~/.claude, ~/.copilot, ~/.codex\n```\n\n`setup` only installs into agent skill roots whose parent directory\nalready exists. Override with `--target PATH` (repeatable) to install\ninto project-local locations like `.github/skills/`.\n\n## Usage\n\n```bash\nlocal-agent-harness assess                 # detect maturity stage + AI-readiness score\nlocal-agent-harness check                  # audit manifests for drift (read-only)\nlocal-agent-harness init  --runtime claude-code --runtime copilot-cli\nlocal-agent-harness refresh --apply        # rewrite stale manifests (backups written)\nlocal-agent-harness report --out .agent/readiness.md\nlocal-agent-harness validate               # regression + redaction smoke checks\n```\n\nThree modes:\n\n| Mode      | Writes? | Use when |\n|-----------|---------|----------|\n| `check`   | no      | Audit-only — CI gate or quick diagnosis. |\n| `init`    | yes     | Render *missing* manifests; never overwrites. |\n| `refresh` | yes (with `--apply`) | Back up + rewrite *stale or relaxed* manifests. |\n\n## Stages (S0 → S3)\n\n| Stage | Repo signal                                  | Default kit                           |\n|-------|----------------------------------------------|---------------------------------------|\n| S0    | empty / no source / no tests / no CI         | AGENTS.md, GROUNDING.md, plan.md      |\n| S1    | source + tests OR CI                         | + pre-commit, devcontainer, verify CI |\n| S2    | source + tests + CI                          | + governance CI, redaction smoke      |\n| S3    | + tags/releases                              | + readiness gate, no-regression check |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrammy-jiang%2Flocal-agent-harness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrammy-jiang%2Flocal-agent-harness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrammy-jiang%2Flocal-agent-harness/lists"}