http://localhost:8080 when the server is running.
Accessing the Console
There are two ways to open the web dashboard:Dashboard Overview
The main dashboard provides real-time insights into proxy usage:Key Metrics
Active Accounts
Number of accounts currently available (not rate-limited or disabled)
Limited Accounts
Accounts temporarily rate-limited with reset countdowns
Total Accounts
All configured accounts regardless of status
Visualizations
- Quota Distribution
- Usage Trends
- Subscription Distribution
Pie Chart: Shows quota usage across all models
- Color-coded by model family (Claude vs Gemini)
- Hover for exact percentages
- Click legend to filter models
- Auto-updates every 30 seconds (with jitter)
Accounts Tab
Manage all your Google accounts from one interface:Account Cards
Each account displays:- Email address (with screenshot mode redaction)
- Subscription tier badge (Ultra/Pro/Free)
- Last used timestamp
- Enable/disable toggle
- Quota progress bars for each model:
- Color-coded by usage level (green → yellow → red)
- Shows percentage remaining and reset time
- Draggable threshold markers for quota protection
- Rate limit status (if active, with countdown)
- Actions menu:
- Refresh tokens and quota
- Configure quota thresholds
- Fix invalid accounts (re-auth)
- Delete account
Adding Accounts
Manual Authorization Mode (Headless Servers)
Manual Authorization Mode (Headless Servers)
Quota Protection Settings
Set minimum quota thresholds to switch accounts before quota runs out: Per-Account Threshold:- Click settings icon on account card
- Set “Quota Threshold” slider (0-99%)
- Click Save
- Switch to Models tab
- Drag the threshold marker on quota bars
- Marker color indicates threshold level
- Overlap detection prevents conflicts
Models Tab
View all available models with quota visualization:Model Cards
Each model shows:- Model ID and family (Claude/Gemini)
- Quota bars per account:
- Stacked horizontal bars
- Color-coded by usage level
- Draggable per-account threshold markers
- Percentage and reset time on hover
- Aggregate quota across all accounts
- Model capabilities (thinking mode, context window)
Interactive Thresholds
Drag markers on quota bars to set per-model, per-account thresholds:- Green marker: 0-20% threshold
- Yellow marker: 21-50% threshold
- Red marker: 51-99% threshold
- Overlap detection: Warns when markers conflict
- Automatic save: Changes persist immediately
Settings Tab
Configure both proxy server and Claude CLI:Server Configuration
Account Selection Strategy
Account Selection Strategy
Choose load balancing strategy:
- Hybrid (default) - Smart multi-signal selection
- Sticky - Cache-optimized, stays on same account
- Round-Robin - Load-balanced, rotates every request
Quota Protection
Quota Protection
Set global minimum quota threshold (0-99%):
- Applies to all accounts and models by default
- Overridden by per-account or per-model settings
- 0 = disabled (no automatic switching)
Retry Configuration
Retry Configuration
- Max Retries: Failed request retry attempts
- Retry Delay: Initial delay in milliseconds
- Max Retry Delay: Maximum backoff delay
Request Timeout
Request Timeout
Maximum time to wait for API response (milliseconds)
Claude CLI Configuration
Edit~/.claude/settings.json directly from the browser:
Connection Mode Toggle
Switch between:
- Proxy Mode: Routes through local proxy (Antigravity)
- Paid Mode: Uses official Anthropic API (requires credits)
Select Models
Configure model mappings:
- Primary model
- Default Opus model
- Default Sonnet model
- Default Haiku model
- Sub-agent model (for faster operations)
Logs Tab
Real-time log streaming with filtering:Features
- Live Streaming: Server-Sent Events (SSE) for real-time logs
- Level Filtering: Show/hide by severity (Debug/Info/Success/Warning/Error)
- Search: Filter logs by content (case-insensitive)
- Auto-scroll: Follows latest logs (disable to scroll history)
- Export: Download logs as JSON (when Developer Mode enabled)
- Clear: Wipe log history
Log Levels
- Debug
- Info
- Success
- Warning
- Error
Detailed diagnostic information (magenta)Only shown when Developer Mode is enabled.
Developer Mode
Enable advanced features for debugging and testing: Settings → Developer Mode → EnableSub-Toggles
When Developer Mode is enabled, additional toggles appear:Screenshot Mode
Screenshot Mode
Redacts email addresses across all views for sharing screenshots:
- Replaces emails with
user***@example.com - Applied to accounts, models, logs, and charts
- Client-side only (no backend changes)
Debug Logging
Debug Logging
Shows verbose debug messages in logs viewer:
- Backend diagnostic info
- Strategy selection details
- Token bucket state changes
- Health score updates
Log Export
Log Export
Shows export button in logs toolbar:
- Download logs as JSON
- Includes timestamps and levels
- Useful for bug reports
Health Inspector
Health Inspector
Shows strategy health panel in Accounts tab (hybrid strategy only):
- Per-account health scores (0-100)
- Token bucket state (tokens/max)
- Failure and success counts
- LRU timestamps
- Real-time score calculations
Placeholder Data
Placeholder Data
Injects 4 dummy accounts for UI testing:
- Varied subscription tiers (Ultra/Pro/Free)
- Different quota levels
- Rate limit scenarios
- Include Real Accounts: Merge with actual accounts
- Client-side only (no backend changes)
Multi-Language Support
The console supports 5 languages:- 🇺🇸 English
- 🇨🇳 Chinese (中文)
- 🇮🇩 Indonesian (Bahasa)
- 🇧🇷 Portuguese (PT-BR)
- 🇹🇷 Turkish (Türkçe)
Security Features
Password Protection
Optional password to restrict web console access:/api/* and web UI require authentication.
Configuration Redaction
Sensitive values are automatically redacted in API responses:- Refresh tokens
- OAuth codes
- API keys
- Passwords
[REDACTED]
Session Management
- Passwords stored as bcrypt hashes
- Session tokens in HTTP-only cookies
- 24-hour session expiration
- Logout clears all session data
Performance Optimization
Smart Polling
The console uses adaptive refresh rates:- Active tab: 30 seconds ±20% jitter
- Background tab: 90 seconds (3x slower)
- Visibility detection: Pauses when browser minimized
Skeleton Loading
All views show skeleton screens during data fetch:- Improves perceived performance
- Matches final layout structure
- Smooth transition to real data
Lazy Loading
Views load on-demand:- Dashboard, Accounts, Models, Settings, Logs
- HTML partials fetched when tab clicked
- Cached after first load
Troubleshooting
Console not loading
Console not loading
Check proxy server is running:If stopped:Verify URL matches configured port:
Data not refreshing
Data not refreshing
Check browser console for errors:
- Open DevTools (F12)
- Check Console tab for JS errors
- Check Network tab for failed requests
- Tab in background (3x slower refresh)
- Browser extension blocking requests
- CORS issues (shouldn’t happen on localhost)
OAuth popup blocked
OAuth popup blocked
Allow popups for localhost:
- Check browser address bar for popup icon
- Click “Always allow popups from localhost”
- Try adding account again
Can't save Claude CLI settings
Can't save Claude CLI settings
Check file permissions:Ensure proxy has write access. If running as systemd service, set:
Charts not displaying
Charts not displaying
Ensure Chart.js is loaded:
- Check browser console for errors
- Verify network connectivity (Chart.js from CDN)
- Try hard refresh (Ctrl+Shift+R)
Keyboard Shortcuts
| Key | Action |
|---|---|
| Escape | Clear search input |
| Tab | Navigate between form fields |
| Enter | Submit forms |
| Space | Toggle checkboxes and switches |
Next Steps
Account Management
Add and configure Google accounts
Load Balancing
Optimize multi-account distribution strategies
Claude Code Setup
Configure Claude CLI to use the proxy
API Reference
Programmatic access to proxy endpoints