| name | smithers-ask-human |
| description | Raise a blocking human-approval request from inside a run and wait for the decision. Use when blocked, uncertain, or about to do something irreversible — never guess. Run `bunx smithers-orchestrator ask-human --help` for usage details. |
| requires_bin | bunx |
| command | bunx smithers-orchestrator ask-human |
bunx smithers-orchestrator ask-human
Raise a blocking human-approval request from inside a run and wait for the decision. Use when blocked, uncertain, or about to do something irreversible — never guess.
Arguments
| Name | Type | Required | Description |
|---|
prompt | string | yes | The decision or question to put to a human |
Options
| Flag | Type | Default | Description |
|---|
--context | string | | Extra context appended to the prompt |
--choices | string | | Comma-separated choices; makes this a fixed-choice decision |
--runId | string | | Run to attach to (default: SMITHERS_RUN_ID or the single active run) |
--node | string | | Node id to attach to (default: SMITHERS_NODE_ID or 'agent-ask') |
--iteration | number | | Loop iteration (default: SMITHERS_ITERATION or 0) |
--timeout | number | | Seconds to wait before the request expires (0/unset = no timeout) |
--poll | number | | Poll interval in seconds while blocking (default 3) |
