Troubleshooting

This section addresses common issues users encounter with Quotio and provides steps to resolve them.

Connection Issues

"API Connection Failed"

Symptoms: Provider shows error status, unable to fetch quota. Fix:

1. Check your internet connection.
2. For CLI providers (Claude, Gemini, etc.): Re-run authentication in the Providers tab.
3. For service accounts (Vertex AI): Verify JSON file is valid and re-upload if needed.
4. Check logs in the Logs tab for detailed error messages.

"Rate Limit Exceeded" (Upstream)

Symptoms: Requests fail even though Quotio shows available quota. Fix:

1. This indicates the provider's instantaneous rate limit (RPM/TPM) was hit.
2. Quotio should auto-failover if a backup is configured.
3. If no backup exists, wait for the provider's reset window (usually 1 minute).

Application Issues

Menu Bar Icon Not Appearing

Fix:

1. Open Activity Monitor.
2. Search for "Quotio".
3. Force Quit the process.
4. Relaunch the app from the Applications folder.

Usage Not Updating

Fix:

1. Some providers have a delay in reporting usage (up to 5-10 minutes).
2. Force a refresh by clicking the refresh button in the Dashboard or menu bar.
3. For CLI providers, ensure the authentication is still valid.
4. Check the Logs tab for any quota fetching errors.

Logs

For detailed troubleshooting, use the built-in Logs viewer:

1. Go to the Logs tab in the main app window.
2. View real-time logs from CLIProxyAPI.
3. Filter by log level (All, Info, Warn, Error).
4. Search for specific error messages.
5. Use auto-scroll to follow new log entries.

The Logs tab provides comprehensive debugging information without needing to access system log files.

Next Steps

Integrate Quotio with your command line tools.

CLI Integration