---
name: smithers-claude
description: "Protocol commands for the Claude Code plugin: mirror runs into /workflows and notify the session. Run `smithers claude --help` for usage details."
requires_bin: smithers
command: smithers claude
---

# smithers claude monitor

Follow the runs this session subscribed to (claude tick / claude subscribe) and print one NDJSON line per actionable transition (approval pending, human request, failed, stalled); --transitions all adds finished/cancelled/continued, --all-runs follows every run in the workspace. Backs the plugin's background monitor.

## Options

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--intervalMs` | `number` | `2000` | Poll interval in ms |
| `--stalledAfterMs` | `number` | `120000` | Heartbeat age that flags a running run as stalled |
| `--ticks` | `number` |  | Stop after N polls (default: run until killed) |
| `--transitions` | `string` | `actionable` | Which transitions stream: actionable (approvals, human requests, failures, stalls) or all (also finished/cancelled/continued) |
| `--allRuns` | `boolean` | `false` | Follow every run in the workspace instead of only the runs this session subscribed to (via claude tick / claude subscribe) |

---

# smithers claude node-wait

Block until one node reaches a terminal state, then print its final state and output. Returns timedOut: true on --timeout-ms expiry (re-invoke to keep waiting).

## Arguments

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `nodeId` | `string` | yes | Node ID to wait on |

## Options

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--runId` | `string` |  | Run ID that owns the node |
| `--iteration` | `number` |  | Loop iteration (default: latest) |
| `--timeoutMs` | `number` | `480000` | Max wait in ms before returning timedOut: true |
| `--intervalMs` | `number` | `1000` | Poll interval in ms |
| `--maxOutputChars` | `number` | `2000` | Truncate the node output to this many chars |

---

# smithers claude subscribe

Subscribe this session's background monitor to a run (done automatically by `claude tick` and Claude-launched runs); the monitor only notifies about subscribed runs.

## Arguments

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `runId` | `string` | yes | Run ID the session's monitor should follow |

---

# smithers claude tick

One /workflows mirror frame for a run: status, phase plan, nodes, deltas since --after-seq, outputs, approvals. --wait blocks until something relevant changes.

## Arguments

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `runId` | `string` | yes | Run ID to mirror |

## Options

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--afterSeq` | `number` | `0` | Event-log cursor from the previous tick's `seq` |
| `--wait` | `boolean` | `false` | Block until a mirror-relevant event lands after --after-seq (or timeout) |
| `--timeoutMs` | `number` | `420000` | Max wait in ms before returning timedOut: true |
| `--intervalMs` | `number` | `750` | Wait poll interval in ms |
| `--maxOutputChars` | `number` | `2000` | Truncate node outputs to this many chars |
| `--collapsePhases` | `boolean` | `false` | Collapse the phase plan to a single phase |

---

# smithers claude unsubscribe

Stop this session's background monitor from following a run (outside a Claude Code session it drops the run for every session).

## Arguments

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `runId` | `string` | yes | Run ID the session's monitor should follow |