CLI
fh doctor
Diagnose workspace, tools, and live model connectivity.
fabric-harness doctor [--target node|temporal-worker] [--model provider/model] [--tools] [--live] [--json]fh doctor validates that your workspace is set up correctly and (optionally) that a real model can be invoked.
Options
| Flag | Description |
|---|---|
--target <node|temporal-worker> | Validate the chosen run target. |
--model <provider/model-id> | Probe a specific model (combine with --live). |
--tools | Enumerate built-in tools and required binaries (docker, gh, etc.). |
--live | Make a small live request against the model provider. |
--json | Emit a machine-readable report. |
Examples
Local readiness
fh doctor --toolsLive model check
cp .env.example .env.local
# edit .env.local and set OPENAI_API_KEY=...
fh doctor --live --model openai/gpt-5.5Temporal target
fh doctor --target temporal-workerThe doctor checks Temporal connectivity using config/env defaults — make sure FABRIC_TEMPORAL_ADDRESS and your task queue are correct.
What it checks
- Workspace root resolution.
- Agents discovered.
- Built-in tool binaries on PATH (when
--tools). - Model provider configuration.
- Optional live model round-trip when
--live. - Optional Temporal connectivity for
--target temporal-worker.