Fabric Harness in 5 minutes
Create, validate, and run a minimal Fabric Harness agent with no Docker or cloud setup.
Fabric Harness starts with one TypeScript definition: call init(), open a session, and prompt it. The default path uses the lightweight virtual sandbox, so you do not need Docker, Temporal, Cloudflare, or a remote sandbox to start.
Create an agent
npx @fabric-harness/cli init my-agent --template minimal
cd my-agent
npm installValidate readiness
npx fabric-harness doctor --getting-started --toolsThis checks Node, ESM package setup, Fabric dependencies, agent discovery, session storage, model resolution, and built-in tool schemas.
Run it
npx fabric-harness agents
npx fabric-harness run hello --name Preetham --mockOr start the HTTP/SSE dev server:
npx fabric-harness dev --mock
curl http://localhost:3000/jobs/hello \
-H 'content-type: application/json' \
-d '{"name":"Preetham"}'The mock provider requires no API key and still exercises discovery, schema validation, the model loop, and HTTP routing. Remove --mock after configuring a real provider.
Create more definitions without writing boilerplate:
fh new job summarize-report
fh new agent supportChoose the next runtime
| Need | Use |
|---|---|
| Fast no-container agent | sandbox: 'virtual' |
| CI/repo automation with host tools | sandbox: 'local' plus scoped defineCommand() commands |
| Untrusted code or data analysis | Docker sandbox |
| Human approval delays or restart durability | Temporal runtime |
| Edge/serverless endpoint | Cloudflare target |
Start with the minimal template, then add only the enterprise controls your use case needs: policy, approvals, audit, cost budgets, durable workflows, and deployment attestations.