@agent-pattern-labs/create-agent-harness

create-agent-harness

Scaffold a portable agent harness project backed by the ISO toolchain.

The generated project follows the Agent Pattern Labs harness shape:

• agent.md for structured agent instructions.
• iso/ as the source of truth for Codex, Claude Code, Cursor, OpenCode, and Pi output.
• modes/ for workflow procedures.
• templates/ for executable policy and contracts.
• bin/ for deterministic helper commands.
• config/ for user-owned local settings examples.

Usage

npx @agent-pattern-labs/create-agent-harness my-agent-workflow
cd my-agent-workflow
npm install
npm run verify

Preview without writing files:

npx @agent-pattern-labs/create-agent-harness my-agent-workflow --dry-run

CLI

create-agent-harness <dir> [--name <name>] [--description <text>] [--force] [--dry-run]

Flags:

• --name <name> controls the generated package and agent names.
• --description <text> sets the generated package description.
• --force allows writing into a non-empty target directory and overwrites scaffold-owned files.
• --dry-run prints the file plan without writing.

Generated Scripts

The scaffolded project includes:

npm run plan          # show the ISO pipeline plan
npm run build:config  # generate harness files for supported agent runtimes
npm run verify        # run a dry-run config build
npm run harness       # run the generated local helper CLI