| name | smithers-events |
| description | Query run event history with filters, grouping, and NDJSON output. Run `smithers events --help` for usage details. |
| requires_bin | smithers |
| command | smithers events |
smithers events
Query run event history with filters, grouping, and NDJSON output.
Arguments
| Name | Type | Required | Description |
|---|
runId | string | yes | Run ID to query |
Options
| 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 |