Troubleshooting
Solutions to common issues and problems.
App Won't Start
Check that you're running macOS 14.0 or later and have Apple Silicon. Verify that Claude Code CLI is installed and accessible. Check the Console app for error messages.
Agents Not Responding
Verify Claude Code CLI is configured correctly in Settings. Check your internet connection if using cloud-based models. Review the Flight Recorder for error events.
Graph is Slow
Large projects with many nodes can impact performance. Try using filters to reduce visible nodes, or use focus mode to view smaller subgraphs.
Database Errors
Use the database maintenance tools in Settings → About → Database Maintenance. You can run integrity checks, optimize, and repair the database.