Troubleshooting
Find solutions to common issues and answers to frequently asked questions about the platform.
Having trouble? Find solutions to common issues below, or browse the FAQ for quick answers.
Quick Fixes
Before diving into specific issues, try these common solutions:
- Refresh the page — Resolves most temporary UI issues
- Clear browser cache — Fixes stale data or broken styles
- Check your internet connection — Required for AI features and sync
- Update to the latest version — Desktop app updates include bug fixes
- Check API key validity — Expired or invalid keys cause AI features to fail
Common Issue Categories
Web Platform
| Issue | Likely Cause | Solution |
|---|---|---|
| Can't sign in | Incorrect credentials or expired session | Reset password or try another sign-in method |
| AI features not responding | API key invalid or rate limited | Check API key in Settings > Integrations |
| Slow responses | Large context or complex prompts | Reduce context window or use a faster model |
| Missing team features | Insufficient permissions | Ask your team admin to adjust your role |
| Billing errors | Payment method expired | Update payment method in Settings > Billing |
Desktop App
| Issue | Likely Cause | Solution |
|---|---|---|
| App won't start | Corrupted installation | Reinstall the desktop app |
| Agent not responding | API server not running | Check the sidecar process in Activity Monitor |
| MCP server failed to connect | Invalid configuration | Verify MCP server config in Settings > MCP |
| Memory not working | Embedding model not loaded | Check memory settings and embedding provider |
| Files not accessible | Workspace not configured | Set workspace directory in Settings |
Get More Help
- Common Issues — Detailed solutions for specific problems
- FAQ — Quick answers to common questions