FabricFabricHarness
CLI

fh agents and fh describe

List and inspect workspace agents.

fh agents

fabric-harness agents [--json]

List every agent under .fabricharness/agents/. The default output is human-readable; --json emits a machine-readable summary.

fh agents
fh agents --json

fh describe

fabric-harness describe <agent> [--json]

Show metadata for a single agent: declared model, target default, triggers, and the input/output schema.

fh describe ask
fh describe ask --json

For agents declared with agent({...}), describe shows:

  • name and description,
  • input schema, rendered as JSON Schema,
  • output schema,
  • declared model,
  • triggers (webhook, etc.),
  • run target default,
  • examples (if examples: [...] was provided).

Plain default-exported functions are rejected; every agent should use agent({...}) so describe can expose the contract.

Why this exists

describe is the contract for tooling. Anything that runs Fabric Harness agents — CI, dev servers, deploy pipelines — can use --json to discover schemas without parsing TypeScript.