メニュー
Discover local workflows from .smithers/workflows. Run `smithers workflow --help` for usage details.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | smithers-workflow |
| description | Discover local workflows from .smithers/workflows. Run `smithers workflow --help` for usage details. |
| requires_bin | smithers |
| command | smithers workflow |
Create a new flat workflow scaffold in .smithers/workflows (or the global ~/.smithers with --global).
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Workflow ID |
| Flag | Type | Default | Description |
|---|---|---|---|
--global | boolean | false | Create the workflow in the global ~/.smithers pack (honors SMITHERS_HOME) instead of the local .smithers |
Inspect workflow discovery, preload files, and detected agents.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Workflow ID |
Show workflow metadata and an agent-facing skill preview.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Workflow ID |
List discovered local workflows. System workflows are hidden unless --system is passed.
| Flag | Type | Default | Description |
|---|---|---|---|
--system | boolean | false | Include system workflows (internal plumbing hidden from the default listing) |
Resolve a workflow ID to its entry file.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Workflow ID |
Run a discovered workflow by ID. Omit the ID (or pass --interactive) to pick one interactively.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Workflow ID (omit with --interactive to pick one) |
| Flag | Type | Default | Description |
|---|---|---|---|
--detach | boolean | false | Run in background, print run ID, exit |
--runId | string | Explicit run ID | |
--parentRunId | string | Existing run ID to record as this run's parent (persisted lineage, surfaced by inspect/ps and the MCP run tools) | |
--maxConcurrency | number | Maximum parallel tasks (default: 4) | |
--root | string | Tool sandbox root directory | |
--log | boolean | true | Enable NDJSON event log file output |
--logDir | string | NDJSON event logs directory | |
--allowNetwork | boolean | false | Allow bash tool network requests |
--maxOutputBytes | number | Max bytes a single tool call can return | |
--toolTimeoutMs | number | Max wall-clock time per tool call in ms | |
--hot | boolean | false | Enable hot module replacement for .tsx workflows |
--input | string | Input data as JSON string | |
--annotations | string | Run annotations as a flat JSON object of string/number/boolean values | |
--resume | unknown | false | Resume a previous run. Pass true with --run-id, or pass the run ID directly (e.g. --resume ) |
--force | boolean | false | Resume even if still marked running |
--acceptWorkflowChange | boolean | false | Resume this run after its workflow source changed, re-blessing durability metadata in place; you own replay determinism |
--resumeClaimOwner | string | Internal durable resume claim owner | |
--resumeClaimHeartbeat | number | Internal durable resume claim heartbeat | |
--resumeRestoreOwner | string | Internal durable resume restore owner | |
--resumeRestoreHeartbeat | number | Internal durable resume restore heartbeat | |
--serve | boolean | false | Start an HTTP server alongside the workflow |
--supervise | boolean | false | Run the stale-run supervisor loop (with --serve) |
--superviseDryRun | boolean | false | With --supervise, detect stale runs without resuming |
--superviseInterval | string | 10s | With --supervise, poll interval (e.g. 10s, 30s) |
--superviseStaleThreshold | string | 30s | With --supervise, stale heartbeat threshold |
--superviseMaxConcurrent | number | 3 | With --supervise, max runs resumed per poll |
--port | number | 7331 | HTTP server port (with --serve) |
--host | string | 127.0.0.1 | HTTP server bind address (with --serve) |
--authToken | string | Bearer token for HTTP auth (or set SMITHERS_API_KEY); required to bind a non-loopback --host | |
--insecure | boolean | false | Allow binding a non-loopback --host with NO auth (exposes unauthenticated approve/deny/cancel control of the run — dangerous) |
--metrics | boolean | true | Expose /metrics endpoint (with --serve) |
--backend | string | Bootstrap storage selection for a workflow owner or workspace Gateway; not a run-discovery/control flag | |
--postFailure | boolean | true | Auto-launch the post-failure autopsy workflow when this run fails (disable with --no-post-failure or SMITHERS_POST_FAILURE=0) |
--verbose | boolean | false | Show engine info logs (run lifecycle, agent sessions) on interactive runs; the default keeps progress lines + warnings only. Non-TTY/structured output always gets full logs. |
--report | boolean | true | On an interactive run, narrate the result with a cheap/fast agent and open an HTML summary in the browser when it finishes (disable with --no-report or SMITHERS_NO_REPORT=1). |
--prompt | string | Prompt text mapped to input.prompt when --input is omitted | |
--interactive | boolean | false | Pick a workflow and its inputs through interactive terminal prompts, then launch the full-screen TUI monitor for the run (TTY only) |
Generate agent-facing skill docs for local workflows.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Workflow ID, or omit to generate skills for all workflows |
| Flag | Type | Default | Description |
|---|---|---|---|
--output | string | Output file for one workflow, or output directory for all workflows | |
--force | boolean | false | Overwrite existing skill files |
--global | boolean | false | Write skills into the global ~/.smithers pack (honors SMITHERS_HOME) instead of the local .smithers |
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.
