hub
Prime Agent troubleshooting: symptom to safe fix
This hub organizes common failures by exact symptom, affected version, diagnosis, safe fix, verification, and rollback. Each child page targets one failure mode and links back to the related feature or guide. Start with the symptom index or search before attempting destructive recovery steps.
First-party announcement, documentation, release, or installer.
Symptom index
IPython kernel
Crash, hang, or bootstrap failure.
Provider auth
Login, API key, or model selection error.
Daemon mismatch
Client, daemon, or worker version mismatch after update.
Refinement regressions
Bad /refine edit or stale harness behavior.
Recovery steps
Back up session data, choose the least destructive fix, and change one variable at a time so rollback stays possible.
Diagnostic flow
Capture the exact symptom and versions, isolate the failing component, apply the matching child-page fix, then run its verification step.
Known issues
Known failure classes include kernel bootstrap errors, provider availability changes, mixed daemon versions, and over-broad refinements.