Troubleshooting

Guides for diagnosing and resolving common issues.

Diagnostics First

Before diving into specific issues, use the built-in Health view (HeartPulse icon in the activity bar) to check:

• Agent status and version
• CLI availability
• Cache and disk usage
• Active warnings

The Copy Diagnostics button generates a full report for bug reports.

Guides

• Common Issues — Frequent problems and quick fixes
• Agent & CLI — Sidecar crashes, CLI not found, version mismatches
• SSH Connections — Authentication failures, timeouts, agent deployment
• Performance — Slow UI, high memory, large repos
• Reset & Recovery — Clear state, reset settings, recover from corruption