Menu
Inspect and register subscriptions and api keys. Run `smithers agents --help` for usage details.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Drive Smithers, a durable control plane for long-running coding agents. Use when the user wants multi-step, long-running, crash-safe, or human-in-the-loop agent work: "orchestrate agents", "run a workflow", "implement this and review it", "keep iterating until tests pass", "plan then build", or anything that needs retries, approvals, replay, or evals across multiple AI steps. YOU (the agent) run Smithers on the user's behalf; it is not a GUI the human clicks. You are an ORCHESTRATOR: run long-running, multi-step, or background work *through* Smithers, not through your own ad-hoc subagents; spend your time observing the run and reporting.
Drive Smithers, a durable control plane for long-running coding agents. Use when the user wants multi-step, long-running, crash-safe, or human-in-the-loop agent work: "orchestrate agents", "run a workflow", "implement this and review it", "keep iterating until tests pass", "plan then build", or anything that needs retries, approvals, replay, or evals across multiple AI steps. YOU (the agent) run Smithers on the user's behalf; it is not a GUI the human clicks. You are an ORCHESTRATOR: run long-running, multi-step, or background work *through* Smithers, not through your own ad-hoc subagents; spend your time observing the run and reporting.
Query node/run lifecycle history by default; pass --raw for raw agent chunks and all event types. Run `smithers events --help` for usage details.
Output detailed run state. Structured output canonically uses nodes[].nodeId (legacy steps[].id remains for compatibility); --pool tallies attempt engine/model usage. Run `smithers inspect --help` for usage details.
Build a new Smithers workflow from a plain-English description. Dispatches to the create-workflow builder. Run `smithers init` first if the .smithers/ pack is not yet installed. Run `smithers make-workflow --help` for usage details.
Concise run health at a glance: verdict, node counts, agent/model mix, throughput, and the nodes gating progress. Run `smithers status --help` for usage details.
| name | smithers-agents |
| description | Inspect and register subscriptions and api keys. Run `smithers agents --help` for usage details. |
| requires_bin | smithers |
| command | smithers agents |
Register a Smithers agent account (interactive wizard, or non-interactive via flags).
| Flag | Type | Default | Description |
|---|---|---|---|
--provider | string | Provider id; omit to launch the interactive wizard | |
--label | string | Unique label, e.g. 'claude-work' | |
--configDir | string | Path to the per-account CLI config dir (subscription providers) | |
--apiKey | string | API key (api-key providers only) | |
--model | string | Default model for this account | |
--skipLogin | boolean | false | Skip the 'is the dir populated?' check (advanced) |
--force | boolean | false | Register even if no credentials are present |
--replace | boolean | false | Overwrite an existing account with the same label |
--loop | boolean | false | Wizard mode only: keep adding accounts until you say done |
Print a JSON report of the built-in CLI agent capability registries.
Validate built-in CLI agent capability registries and command-surface contracts.
| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Print the doctor report as JSON |
List all registered Smithers agent accounts. Use --format json for machine output.
Remove a Smithers agent account by label.
| Name | Type | Required | Description |
|---|---|---|---|
label | string | yes | Account label to remove |
| Flag | Type | Default | Description |
|---|---|---|---|
--silent | boolean | false | Do not error if the label is not registered |
Spawn the account's underlying CLI with --version to verify it is reachable.
| Name | Type | Required | Description |
|---|---|---|---|
label | string | yes | Account label to ping |
