docs: sync README with source of truth (#2932)

Co-authored-by: spawn-qa-bot <qa@openrouter.ai>
Co-authored-by: L <6723574+louisgv@users.noreply.github.com>
This commit is contained in:
A 2026-03-23 18:43:49 -07:00 committed by GitHub
parent 56f7840f0c
commit 75cff300b4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -236,6 +236,20 @@ If spawn fails to install, try these steps:
spawn openclaw digitalocean
```
### Headless JSON mode — agent exits immediately
When using `--headless --output json` with Claude Code, you must also pass `--prompt` (or `-p`). Without it, Claude exits with `Input must be provided through stdin or --prompt` and the JSON output will show `"status":"error"`:
```bash
# WRONG — Claude exits immediately
spawn claude gcp --headless --output json
# RIGHT — provide a prompt
spawn claude gcp --headless --output json --prompt "Fix all linter errors"
```
Note: auto-update messages may appear before the JSON on older CLI versions. Run `spawn update` to get the fix.
### Agent launch failures
If an agent fails to install or launch on a cloud: