CLI
CLI Overview
One binary for run, build, dev, deploy, inspect, and replay.
The Fabric Harness CLI is a single binary that drives the entire framework: discovering agents, running them locally, building deployment artifacts, starting the dev server, inspecting persisted sessions, and managing approvals, tasks, artifacts, and builds.
Invocation
The CLI is published as fabric-harness with fh as an exact alias:
fabric-harness --help
fh --helpUntil the CLI is published, run it from the built monorepo:
node packages/cli/dist/bin/fabric-harness.js --help
pnpm fh --helpSynopsis
fabric-harness --help
fabric-harness run <agent> [options]
fabric-harness agents [--json]
fabric-harness describe <agent> [--json]
fabric-harness build [--target node|temporal-worker|docker|foundry-hosted-agent|cloudflare] [options]
fabric-harness dev [--target node|cloudflare] [options]
fabric-harness doctor [--target node|temporal-worker] [--model provider/model] [--tools] [--live] [--json]
fabric-harness sessions
fabric-harness builds
fabric-harness inspect <session-id>
fabric-harness logs <session-id> [--events]
fabric-harness checkpoints <session-id>
fabric-harness artifacts <session-id> [--json]
fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]
fabric-harness metrics <session-id> [--json]
fabric-harness tasks <session-id> [--json]
fabric-harness task <session-id> <task-id> [--json]
fabric-harness cancel-task <session-id> <task-id> [--actor <id>] [--reason <text>]
fabric-harness compact <session-id> [--keep <n>] [--summary <text>]
fabric-harness replay <session-id>
fabric-harness approvals <session-id> [--pending] [--state]
fabric-harness approve <session-id> <approval-id> [--actor <id>] [--reason <text>]
fabric-harness reject <session-id> <approval-id> [--actor <id>] [--reason <text>]
fabric-harness verify-attestation <build-dir-or-attestation>
fabric-harness verify-provenance <build-dir-or-provenance>
fabric-harness temporal-worker [--task-queue <name>] [--address <host:port>] [--env <file>]
fabric-harness add [connector] [--print]Command groups
| Group | Commands | Page |
|---|---|---|
| Run agents | run | run |
| Discover | agents, describe | agents |
| Build | build, builds, verify-attestation, verify-provenance | build, builds |
| Dev server | dev | dev |
| Diagnostics | doctor | doctor |
| Sessions | sessions, inspect, logs, replay, metrics, compact | sessions |
| Tasks | tasks, task, cancel-task | tasks |
| Approvals | approvals, approve, reject | approvals |
| Artifacts & checkpoints | artifacts, artifact get, checkpoints | artifacts |
| Temporal | temporal-worker | temporal-worker |
| Recipes | add | add |
Global options
| Flag | Purpose |
|---|---|
-h, --help | Print help text. |
--env <file> | Load .env-style variables before run/dev/temporal-worker. Repeatable; shell env wins. |
Configuration defaults
.fabricharness/config.ts may set:
run.target,run.model,run.idPrefix,temporal.address,temporal.taskQueue,agent.model.
CLI flags always win over config. See Configuration.