Troubleshooting
Common issues and solutions for tribecode analytics collection
Quick Diagnosis
Start with tribe status to check system health, then use tribe logs to monitor real-time activity.
Data Collection Issues
tribecode Not Collecting Data
Symptoms:
- Analytics dashboard shows "No data collected"
- Using AI tools but no events appear
tribe statusshows "Collection: Disabled"
Solutions:
1. Enable Collection
2. Check Authentication
3. Verify Tool Support
Ensure you're using supported AI tools:
- Claude Code (VS Code extension)
- Cursor AI
- GitHub Copilot
- Codeium
- Tabnine
Partial Data Collection
Symptoms:
- Some tools tracked, others missing
- Intermittent data collection
- Token counts seem low
Solutions:
Check which tools are being monitored:
Restart collection to refresh tool detection:
Authentication Problems
Login Issues
Common Symptoms:
- "Authentication failed" errors
- "Invalid session" messages
- Redirected to login repeatedly
Solutions:
1. Re-authenticate
2. Clear Stored Credentials
Clear cached authentication:
3. Network/Firewall Issues
Ensure your firewall allows connections to tribecode.ai and GitHub. Corporate networks may block OAuth flows.
API & Integration Issues
API Key Problems
Symptoms:
- 401 Unauthorized API responses
- "Invalid API key" errors
- Rate limiting issues
Solutions:
1. Verify API Key
Test API key:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://tribecode.ai/api/data/events2. Generate New Key
Visit https://tribecode.ai/settings → API Keys → Generate New Key
3. Check Rate Limits
Default limits: 1000 requests/hour. Contact support for higher limits. See API Reference for details.
Performance Issues
Slow Dashboard or High CPU Usage
Symptoms:
- Dashboard takes long to load
- High CPU usage from tribecode processes
- System becomes sluggish
Solutions:
1. Check System Resources
Check TRIBE process usage:
Monitor resource usage:
2. Reduce Collection Frequency
Configure lighter collection:
3. Clean Up Old Data
Archive old analytics (older than 90 days):
Advanced Diagnostics
Debug Mode
Enable verbose logging for detailed troubleshooting:
Enable debug logging:
Or start with debug mode:
System Information
Gather system info for support requests:
Generate diagnostic report:
Check system compatibility:
Reset Everything
Nuclear option - complete reset (will lose data):
⚠️ WARNING: This deletes all analytics data
Getting Help
If these solutions don't resolve your issue, here's how to get additional support:
Community Support
Enterprise Support
Before Contacting Support
Please include the output of tribe diagnostic andtribe status with your support request. This helps us diagnose issues faster.
Related Resources
Getting Started
Complete setup guide and initial configuration.
CLI Commands
Complete reference for all tribecode CLI commands.
API Reference
Programmatic access and integration guides.