{"_id":"create-agent-harness","name":"create-agent-harness","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"create-agent-harness","version":"0.1.0","description":"Cross-platform scaffolder for a multi-agent (Claude / Codex / Gemini) project harness with rule files, MCP, and a task router.","type":"module","bin":{"create-agent-harness":"bin/create.mjs"},"engines":{"node":">=18"},"scripts":{"test":"node --test tests/smoke.test.mjs"},"keywords":["claude","claude-code","codex","gemini","mcp","scaffold","multi-agent","create","initializer"],"author":{"name":"neohum","email":"neohum77@gmail.com"},"license":"MIT","homepage":"https://github.com/neohum/create-agent-harness#readme","repository":{"type":"git","url":"git+https://github.com/neohum/create-agent-harness.git"},"bugs":{"url":"https://github.com/neohum/create-agent-harness/issues"},"publishConfig":{"access":"public"},"gitHead":"f6b51e3370eb82c539d73c37568dfb9f2dd0526f","_id":"create-agent-harness@0.1.0","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-7RDOVX2FBPphGjL0FJE/FTJpQsW1sKLGyJdUYIFJFuQaTMKf/JedeXVkG35Tv7U/yvTIHQxJPjrOAv/HS6Pppw==","shasum":"3ae702943fa9d5c47841f91ea455ae36dbd8ab04","tarball":"https://registry.npmjs.org/create-agent-harness/-/create-agent-harness-0.1.0.tgz","fileCount":21,"unpackedSize":35018,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICKyMo9dDmht/0afR0oz2b01AhWqpQN2L8tFGmQI3F3tAiEA4bwJcIZXdGDpDmUuKA/vpfCLnWXH4eAIZXWhwxnxtZQ="}]},"_npmUser":{"name":"neohum77","email":"neohum77@gmail.com"},"directories":{},"maintainers":[{"name":"neohum77","email":"neohum77@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/create-agent-harness_0.1.0_1779239758684_0.3441295522093415"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-20T01:15:58.541Z","0.1.0":"2026-05-20T01:15:58.841Z","modified":"2026-05-20T01:15:59.047Z"},"maintainers":[{"name":"neohum77","email":"neohum77@gmail.com"}],"description":"Cross-platform scaffolder for a multi-agent (Claude / Codex / Gemini) project harness with rule files, MCP, and a task router.","homepage":"https://github.com/neohum/create-agent-harness#readme","keywords":["claude","claude-code","codex","gemini","mcp","scaffold","multi-agent","create","initializer"],"repository":{"type":"git","url":"git+https://github.com/neohum/create-agent-harness.git"},"author":{"name":"neohum","email":"neohum77@gmail.com"},"bugs":{"url":"https://github.com/neohum/create-agent-harness/issues"},"license":"MIT","readme":"# create-agent-harness\n\nCross-platform scaffolder for a multi-agent project harness:\n**Claude** (architect) + **Gemini** (researcher) + **Codex** (typist), wired with rule files, MCP servers, and a heuristic task router.\n\n> Works on macOS, Linux, and Windows. Requires Node ≥ 18.\n\n## Use\n\n```bash\n# from any directory\nnpx create-agent-harness@latest my-project\ncd my-project\n# then open CLAUDE.md / lat.md / DESIGN.md and fill in the project-specific blanks\n```\n\nApply to an existing repo without clobbering its `.claude/settings.json`:\n\n```bash\nnpx create-agent-harness@latest . --merge\n```\n\n## What you get\n\n```\nmy-project/\n├── CLAUDE.md              # senior-engineer conventions + lane rules\n├── lat.md                 # repo map (top-level layout, module ownership)\n├── DESIGN.md              # UI/UX system contract\n├── .claude/\n│   ├── settings.json      # permissions for claude/codex/gemini/gh/git\n│   ├── agents/\n│   │   ├── architect.md   # Claude\n│   │   ├── researcher.md  # Gemini\n│   │   └── typist.md      # Codex\n│   └── commands/\n│       ├── route.md       # /route\n│       ├── analyze.md     # /analyze\n│       └── design.md      # /design\n├── .mcp.json              # filesystem / github / postgres\n├── scripts/\n│   ├── route.mjs          # picks the right agent\n│   ├── invoke-claude.mjs\n│   ├── invoke-codex.mjs\n│   └── invoke-gemini.mjs\n└── docs/HARNESS.md        # how the harness works\n```\n\n## Design choices (and what we deliberately left out)\n\n- **No third-party orchestrators.** Heuristic router in 80 LOC beats a framework that breaks on upgrade. Replace it when you outgrow it.\n- **No \"claude-hud\" / \"plannotator\" / similar tools** are auto-installed — they're listed in `docs/HARNESS.md` as optional pointers because their stability isn't something we can guarantee per platform.\n- **MCP set is small on purpose:** `filesystem`, `github`, `postgres`. Add more in `.mcp.json` as you need them.\n\n## Optional add-ons (opt-in, not bundled)\n\nThese third-party tools pair well with the harness. They are **not** auto-installed because their stability and cross-platform behavior is out of our control. See [`docs/EXTERNAL_TOOLS_REPORT.md`](./docs/EXTERNAL_TOOLS_REPORT.md) for the full Gemini-generated review with risk ratings.\n\n| Tool                                          | What it adds                                              | When to install                                  |\n| --------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------ |\n| [`claude-hud`](https://github.com/jarrodwatts/claude-hud) | terminal HUD: context %, token spend, tool use            | always, if you run long agent sessions           |\n| [`plannotator`](https://github.com/backnotprop/plannotator) | visual review of agent-generated plans before execution   | when changes have high blast radius              |\n| [`notebooklm-mcp`](https://github.com/jacob-bd/notebooklm-mcp-cli) | MCP server backed by NotebookLM for heavy RAG             | when researcher tasks need persistent doc corpus |\n| [`andrej-karpathy-skills`](https://github.com/forrestchang/andrej-karpathy-skills) | Karpathy-flavored CLAUDE.md guardrails                    | already overlaps with our default `CLAUDE.md` — borrow snippets only |\n| [`myclaude`](https://github.com/stellarlinkco/myclaude) | richer multi-agent workflow templates                     | when the 3-agent split feels too narrow          |\n\n> URLs above were resolved by Gemini and spot-verified with `gh repo view` — all five repos exist, are public, and were active in the last 30 days as of the report date. Re-verify before integration.\n\n## CLI flags\n\n| Flag             | Meaning                                                    |\n| ---------------- | ---------------------------------------------------------- |\n| `<target-dir>`   | folder to scaffold into (created if missing)               |\n| `--name <name>`  | project name written into rule files (default: folder name)|\n| `--merge`        | merge `.claude/settings.json` with existing instead of overwriting |\n| `--no-install`   | skip the postinstall hints                                 |\n\n## Develop locally\n\n```bash\ncd tools/agent-harness\nnode --test tests/smoke.test.mjs    # smoke tests\nnode bin/create.mjs /tmp/demo --name demo\n```\n\n## Maintenance — dhelper ↔ GitHub template sync\n\nThis package is authored inside `dhelper/tools/agent-harness/` and mirrored to\n`github.com/neohum/create-agent-harness` (template repo). To push local changes\nupstream:\n\n```powershell\n# from dhelper repo root\ngit subtree push --prefix=tools/agent-harness `\n  https://github.com/neohum/create-agent-harness.git main\n```\n\nTo pull upstream-only changes back into dhelper:\n\n```powershell\ngit subtree pull --prefix=tools/agent-harness `\n  https://github.com/neohum/create-agent-harness.git main --squash\n```\n","readmeFilename":"README.md","_rev":"1-35f9a28b4d330f894addaf11eb15787c"}