Reference

Tables of what claw-drive exposes.

MCP tools

Tool	Purpose
`start_session`	Start a driven session. Returns `{session_id, watch_command, notification_contract}`. The `notification_contract` field describes the session's vocabulary, surface modes, watch flags, and idle default — drivers can read it instead of hardcoding to a specific claw-drive version. Optional `wrapper: false` opts out of the sentinel-token wrapper (B doesn't receive the system-prompt injection); when set, `notification_contract.wrapper_enabled` is `false`.
`stop_session`	Reap B. Keeps the session dir for inspection.
`send_turn`	Non-blocking send of a user turn to B. Returns `turn_id`.
`poll_turn`	Fetch events and status for one turn. Supports long-poll.
`poll_session`	Tail all events for a session. Use sparingly — MCP token cap.
`list_sessions`	List live and orphaned sessions.
`resolve_tool_call`	Approve/reject a paused tool call. Optional `remember_as_policy`.
`update_policy`	Replace a session's policy at runtime.
`interrupt_turn`	SIGINT B to cancel the current turn.
`provide_tool_output`	Inject human-run command output back into B's conversation. Auto-resolves pending defer.

CLI commands

Command	Purpose
`sessions`	List sessions (live and orphaned).
`show <session>`	State plus last 20 events.
`tail <session> [--since N] [--follow]`	Stream events from a sequence number.
`pending [<session>]`	List awaiting-approval calls.
`approve <call_id> [--reason R] [--remember]`	Approve a paused call.
`reject <call_id> [--reason R] [--remember]`	Reject a paused call.
`defer <call_id> [--reason R] [--remember]`	Defer a paused call to the human (v0.3+).
`send <session> "<msg>"`	Send a user turn.
`start --cwd PATH [--policy FILE] [--brief FILE]`	Start a session from the CLI.
`stop <session>`	Reap B.
`interrupt <session> <turn>`	SIGINT B.
`policy <session> [--set FILE] [--show]`	View or replace a session's policy.
`policy-test '<command>' [flags]`	Diagnose a tool call against a policy. See Policies → Testing a policy.
`prune [--older-than 24h]`	Remove dead sessions older than cutoff.
`watch <session> [--since N \| --replay] [--only KIND[,KIND]... \| --decision-only] [--no-token-filter] [--idle-after SECONDS]`	Stream noteworthy events as JSONL. Used by Monitor flows. Sentinel filter is on by default — `turn_completed` surfaces only when the trailing token is `[NEEDS-INPUT]` or `[DONE]`. `--no-token-filter` disables the filter entirely. `--decision-only` and `--only` are kind-level filters that compose with the sentinel filter. `--idle-after SECONDS` emits a synthetic `idle` event after N seconds of no surfaced activity (default `600`; `0` disables). See Driving patterns → Sentinel tokens.
`provide-output <call_id> [flags]`	Relay human-run output to a deferred call.