Everyday commands
Logs
~/.prime/agent/logs/. One rotating file per component (daemon, kernel, web). Tail them when a run misbehaves; the log lines line up with the tool cards you saw in the UI.
Web health
The web app exposesGET /api/health (web/app/src/routes/api/health.ts) which reports kernel readiness via useKernelHealth. Use it as a liveness probe if you run the web server under a supervisor.
Telemetry
Opt-in only. When enabled,packages/coding-agent/src/core/telemetry.ts batches events into telemetry.json under the config dir. Nothing leaves the machine unless you explicitly wire an exporter.
When to reach for /doctor
- The CLI hangs on startup.
- A session won’t attach.
- IPython cells fail with a kernel error.
- After an upgrade.
/doctor --fix is the safe first move — it inspects the daemon socket, the kernel venv, and the auth store, and rebuilds what’s rebuildable.