@fabric-harness/cli

Command-line interface for Fabric Harness — run, build, deploy, inspect, and operate agents from one binary.

Install

npm install -g @fabric-harness/cli
# or
pnpm add -g @fabric-harness/cli

Provides two commands (aliases of each other):

• fabric-harness
• fh

Quick start

fh init                                             # scaffold a new .fabricharness/ workspace
npm install                                         # install the deps the scaffolder declared
fh agents                                          # list workspace agents
fh describe hello                                   # show agent metadata + schema
fh run hello --payload '{"name":"Ada"}'             # one-shot run
fh dev                                              # watch mode — POST /agents/:name
fh build --target node                              # build deployable artifact
fh sessions                                         # list persisted sessions
fh inspect <session-id>                             # session history snapshot
fh metrics <session-id>                             # tokens, tools, mounts, per-source bytes

What's in the box

• fh init [--dir <path>] [--model <provider/model>] [--force] — scaffold .fabricharness/ (sample agent, role, skill, config) plus package.json, tsconfig.json, AGENTS.md. Idempotent.
• fh run / dev — local execution against any workspace agent.
• fh build — emit deployable artifacts for: node, docker, temporal-worker, cloudflare, foundry-hosted-agent, aks (Dockerfile + k8s/ Deployment/Service manifests with health probes), aca (Dockerfile + azure.yaml + infra/main.bicep for azd up).
• fh agents / describe — agent discovery and schema introspection.
• fh sessions / inspect / logs / metrics — session history operations. fh metrics reports tokens, tools, shells, mounts (count / files / bytes), and top tools / sources.
• fh replay <id> [--from <step-id>] [--limit <n>] — read-only active-path filter from a specific entry id.
• fh approvals / approve / reject — capability-policy approval handling.
• fh checkpoints / artifacts / artifact get — durable state inspection.
• fh tasks / task / cancel-task — task tree management.
• fh doctor — environment + model provider validation (--live to ping the model).
• fh temporal-worker — start a local Temporal worker with Fabric activities.
• fh add — install connector recipes (sandbox, MCP, data).
• fh verify-attestation / verify-provenance — supply-chain checks for built artifacts.

Run fh --help for the full surface.

Documentation

• CLI reference
• Getting started
• Headless mode — the 10-line agent path

License

Apache-2.0