create-agent-harness

Scaffold your own focused AI agent harness — like ruflo, uniquely yours.

Quick start

npx create-agent-harness my-bot

You'll be prompted for template, host, description. Out comes a complete npm package ready to npm publish.

Non-interactive

npx create-agent-harness my-legal-bot \
  --template vertical:legal \
  --host claude-code \
  --description "Contract redline + risk rating"

Templates

| Template | Best for | |---|---| | minimal | Custom starter — kernel only | | vertical:devops | Incident response, on-call workflows | | vertical:support | Customer support, KB-RAG, escalation | | vertical:trading | Quant trading (paper-default, circuit breakers) | | vertical:legal | Contract review with citation checking | | vertical:research | Multi-source dossier with evidence grading |

Hosts

--host selects which host adapter ships with your harness:

| Host | What you get | |---|---| | claude-code | .claude/settings.json with MCP + hooks | | codex | ~/.codex/config.toml with [mcp_servers.*] | | pi-dev | Pi extension (TypeScript, no MCP by design) | | hermes | cli-config.yaml + optional-mcps/*.yaml | | openclaw | ~/.openclaw/openclaw.json + workspace SKILL.md + install runbook | | rvm | RVM partition manifest + capability table + wasm-guest + install runbook (hardware-isolated) |

Multi-host: pass --host multiple times.

Also ships the harness CLI

harness sign      # produce/update the witness manifest
harness verify    # check signature
harness doctor    # smoke-check a scaffolded harness
harness help

Eject from ruflo

If you've been using ruflo and want your own focused harness from it:

npx create-agent-harness --from-existing ./

Lifts agents/skills/commands, rewrites every ruflo / claude-flow reference, preserves attribution blocks marked with <!-- ruflo-attribution-block -->.

Full walkthrough

See USAGE.md.

License

MIT