dsh-claude-live

Usage

claude_live task="Refactor src/calc.js and run its tests" permissionMode="full" cwd="/srv/project"

Argument	Required	Meaning
task	yes	Complete, self-contained prompt. The child does not see this conversation.
cwd	no	Working directory. Defaults to the harness process directory.
permissionMode	no	readonly → --permission-mode plan; full → --dangerously-skip-permissions; default (the default) → Claude's own configuration.
model	no	--model override. Omit for Claude's default.

Returns { ok, result, stats: { events, toolCalls, durationMs } }, or { ok: false, error } when the CLI could not start, timed out, was cancelled, or exited without a result event. Every return value is sanitized to strict lossless JSON (no undefined, no NaN/Infinity/-0, no class instances, no cycles) — the harness rejects anything else.

While the run is in flight you see ONE self-updating row under the claude_live call (throttled ≤1/s) — the header tracks the current step, the body is a rolling window of recent digest lines plus a live counter:

claude:Bash · npm test          ← header = current step
▸ claude full: Refactor src/calc.js and run its tests
✱ Reading the module to see what the tests cover
▸ Read: /srv/project/src/calc.js
▸ Bash: npm test
◦ 4 steps · 0:12                ← rolling counter

The row settles to claude:done when Claude finishes. No row-per-step stacking — the transcript stays flat, like the Claude Code CLI.