Menu
Query node/run lifecycle history by default; pass --raw for raw agent chunks and all event types. Run `smithers events --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.
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.
Watch explicitly named stale runs and auto-resume them; pass --all to opt into a workspace-wide sweep. Run `smithers supervise --help` for usage details.
| name | smithers-events |
| description | Query node/run lifecycle history by default; pass --raw for raw agent chunks and all event types. Run `smithers events --help` for usage details. |
| requires_bin | smithers |
| command | smithers events |
Query node/run lifecycle history by default; pass --raw for raw agent chunks and all event types.
| Name | Type | Required | Description |
|---|---|---|---|
runId | string | yes | Run ID to query |
| Flag | Type | Default | Description |
|---|---|---|---|
--node | string | Filter events by node ID | |
--type | string | Filter by event category (agent, approval, frame, memory, node, openapi, output, revert, run, sandbox, scorer, snapshot, supervisor, timer, token, tool-call, workflow) | |
--since | string | Filter to a recent duration window (e.g. 5m, 2h; a bare number is milliseconds, and logs --since is an event sequence number instead) | |
--limit | number | Maximum events to display (default 1000, max 100000) | |
--json | boolean | false | Output NDJSON for piping |
--groupBy | string | Group output by "node" or "attempt" | |
--watch | boolean | false | Watch mode: append new events as they arrive |
--interval | number | 2 | Watch poll interval in seconds |
--raw | boolean | false | Include raw agent chunk/tool history instead of the default lifecycle-only view |
