Troubleshooting connections

Stream errors

If you see:

Stream error: stream read error: Unexpected EOF

the connection to your model API closed before the reply finished. This is usually network, proxy, or server timeout — not a bad install.

Things to try:

Confirm the model server is up: ninja doctor
Check openai_base_url / subagent URLs match a working OpenAI-compatible endpoint
If you use a reverse proxy or VPN, raise idle/read timeouts for long generations
Retry with a shorter prompt; large file context makes long requests more likely to hit middlebox limits

Contact support if it keeps happening on a known-good endpoint. Support may send a private diagnostics one-liner — it is not part of the public product page.

Multi-endpoint tip

Planner and subagents can use different URLs. A failure while planning may be the planner endpoint; a failure during coding may be the coder endpoint. Check which role was active when the error appeared.