Solutions for common issues with MiraBridge.
Connection Issues
Cannot connect to Gateway
- Check your internet connection
- Verify the Gateway URL in settings
- Try restarting VS Code or the mobile app
- Check the health endpoint:
curl https://api.mirabridge.io/api/status/health
WebSocket disconnects frequently
- Ensure a stable internet connection
- The Gateway has a 15-second connection timeout
- Check for firewall or proxy blocking WebSocket connections
Authentication Issues
Sign-in fails
- Clear browser cookies and try again
- Ensure you are using a supported OAuth provider (GitHub or Google)
- Check that your account is not locked
Token expired
- The extension automatically refreshes tokens
- If auto-refresh fails, sign out and sign in again
Extension Issues
Extension not loading
- Check the VS Code output panel for error messages
- Try disabling and re-enabling the extension
- Update to the latest version
Chat not responding
- Verify the WebSocket connection (status bar indicator)
- Check your token balance if not using BYOK
- Try switching AI models
Mobile Sync Issues
Phone not receiving messages
- Ensure both devices are signed in to the same account
- Check push notification permissions
- Verify device pairing status
Next Steps
- API Reference — API endpoints for debugging
- Security Overview — authentication details