Management Dashboard - switchAILocal

Overview

The Management Dashboard is a modern, single-file React web UI (226 KB, zero dependencies) that provides visual configuration and monitoring for switchAILocal.

Accessing the Dashboard

The dashboard is available at:

http://localhost:18080/management

The dashboard requires authentication using your management secret key configured in config.yaml.

Configuration

Enable Management API

Configure the management API in config.yaml:

config.yaml

remote-management:
  # Whether to allow remote (non-localhost) management access
  allow-remote: false
  
  # Management key (will be hashed on startup)
  secret-key: "your-secure-secret-key"
  
  # Disable the bundled management control panel
  disable-control-panel: false
  
  # GitHub repository for control panel assets
  panel-github-repository: "https://github.com/traylinx/switchAILocal-Management-Center"

Security Settings

allow-remote:

false (default): Only localhost can access management endpoints
true: Allow remote access (requires authentication)

secret-key:

Used for all management API requests
Stored as a hash after first startup
Leave empty to disable Management API entirely (404 for all routes)

disable-control-panel:

false (default): Dashboard is available
true: Disable the web UI (API endpoints still work)

First-Time Setup

Set Management Key

Edit config.yaml and set a strong secret key:

remote-management:
  secret-key: "your-secure-random-key-here"

Start Server

./switchAILocal

Or with Docker:

docker-compose up -d

Access Dashboard

Navigate to http://localhost:18080/management and enter your secret key.

Dashboard Features

Provider Configuration

Visually manage AI provider credentials and settings:

Add Provider Credentials: Configure API keys for Gemini, Claude, OpenAI, and more
OAuth Management: View and manage OAuth sessions
Model Discovery: Trigger automatic model discovery
Load Balancing: Configure multiple credentials per provider

Model Routing

Configure intelligent routing behavior:

Routing Strategy: Choose between round-robin and fill-first
Model Aliases: Create friendly names for models
Auto Model Priority: Set fallback order for auto model selection
Cortex Router Matrix: Map intents to specific models

Real-Time Monitoring

Provider Health Status

Monitor the health of all configured providers:

GET /v0/management/heartbeat/status

Displays:

Provider availability
Response latency
Last successful request
Error rates
Quota usage

Performance Analytics

View detailed performance metrics:

GET /v0/management/analytics

Metrics include:

Total Requests: Count per provider and model
Success Rates: Percentage of successful completions
Average Latency: Response time statistics
Error Rates: Failure analysis
Cost Tracking: Token usage and estimated costs

Memory System Stats

Monitor the learning system:

GET /v0/management/memory/stats

Shows:

User preferences per API key
Provider bias scores
Model performance history
Routing decision cache

Live Log Streaming

View real-time application logs directly in the dashboard:

Filter by log level (DEBUG, INFO, WARN, ERROR)
Search log content
Auto-scroll to latest entries
Download log files

Configuration Editor

Edit configuration settings through the web UI:

# Get current config
GET /v0/management/config

# Update specific fields
PATCH /v0/management/config

Supported operations:

Update basic settings (port, debug mode)
Modify provider credentials
Adjust routing strategies
Configure intelligence features

Management API Reference

All dashboard features are backed by REST endpoints.

All management endpoints require the X-Management-Key header with your secret key.

Monitoring Endpoints

curl http://localhost:18080/v0/management/analytics \
  -H "X-Management-Key: your-secret-key"

curl http://localhost:18080/v0/management/heartbeat/status \
  -H "X-Management-Key: your-secret-key"

curl http://localhost:18080/v0/management/memory/stats \
  -H "X-Management-Key: your-secret-key"

curl http://localhost:18080/v0/management/steering/rules \
  -H "X-Management-Key: your-secret-key"

Operations Endpoints

curl -X POST http://localhost:18080/v0/management/steering/reload \
  -H "X-Management-Key: your-secret-key"

curl -X POST http://localhost:18080/v0/management/hooks/reload \
  -H "X-Management-Key: your-secret-key"

curl -X POST http://localhost:18080/v0/management/discover_models \
  -H "X-Management-Key: your-secret-key"

curl -X POST http://localhost:18080/v0/management/cache/clear \
  -H "X-Management-Key: your-secret-key"

Configuration Endpoints

curl http://localhost:18080/v0/management/config \
  -H "X-Management-Key: your-secret-key"

curl -X PATCH http://localhost:18080/v0/management/config \
  -H "X-Management-Key: your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "debug": true,
    "routing.strategy": "round-robin"
  }'

OAuth Session Management

Manage OAuth tokens for CLI and cloud providers:

View Active Sessions

curl http://localhost:18080/v0/management/oauth/sessions \
  -H "X-Management-Key: your-secret-key"

Response:

{
  "sessions": [
    {
      "provider": "gemini",
      "authenticated": true,
      "expires_at": "2026-04-09T10:00:00Z",
      "scopes": ["https://www.googleapis.com/auth/generative-language"]
    }
  ]
}

Revoke Session

curl -X DELETE http://localhost:18080/v0/management/oauth/sessions/gemini \
  -H "X-Management-Key: your-secret-key"

Feedback and Learning

Provide feedback to improve routing decisions:

curl -X POST http://localhost:18080/v0/management/feedback \
  -H "X-Management-Key: your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "req_abc123",
    "rating": 5,
    "comment": "Excellent response quality",
    "helpful": true
  }'

Feedback is used to:

Adjust provider bias scores
Improve model selection confidence
Identify provider quirks
Optimize routing decisions

Intelligence System Controls

Cortex Router Status

View the current state of intelligent routing:

curl http://localhost:18080/v0/management/intelligence/status \
  -H "X-Management-Key: your-secret-key"

Shows:

Router model status
Semantic tier performance
Skill matching statistics
Cache hit rates
Cascade activations

Reload Skills

Hot-reload Cortex Router skills without restarting:

curl -X POST http://localhost:18080/v0/management/intelligence/reload \
  -H "X-Management-Key: your-secret-key"

Hooks and Automation

View and manage webhook hooks:

List Active Hooks

curl http://localhost:18080/v0/management/hooks/status \
  -H "X-Management-Key: your-secret-key"

Reload Hook Configuration

curl -X POST http://localhost:18080/v0/management/hooks/reload \
  -H "X-Management-Key: your-secret-key"

Usage Analytics

Detailed usage statistics when enabled:

config.yaml

usage-statistics-enabled: true

curl http://localhost:18080/v0/management/usage \
  -H "X-Management-Key: your-secret-key"

Response includes:

Request volume per provider
Token consumption
Cost estimates
Peak usage times
Model distribution

Quota Monitoring

Track provider quota usage:

curl http://localhost:18080/v0/management/quota \
  -H "X-Management-Key: your-secret-key"

Displays:

Current quota used per provider
Quota limits
Reset times
Usage trends

Security Best Practices

Production Deployment

Strong Secret Key: Use a cryptographically random key (32+ characters)
Restrict Remote Access: Set allow-remote: false for local-only access
Enable TLS: Use HTTPS in production with valid certificates
Regular Key Rotation: Change the secret key periodically
Monitor Access Logs: Review management API access logs

Network Security

Firewall Rules: Block port 18080 from external networks if not needed
Reverse Proxy: Use nginx or Caddy with authentication
VPN Access: Require VPN for remote management access
API Rate Limiting: Implement rate limits on management endpoints

Troubleshooting

Dashboard Won’t Load

Issue: Dashboard returns 404 or fails to load. Solution:

Verify disable-control-panel: false in config.yaml
Check that secret-key is set (not empty)
Ensure server is running: curl http://localhost:18080/health

Authentication Fails

Issue: Invalid management key error. Solution:

Verify the key matches config.yaml
Restart server if you changed the key
Check logs for hashing errors

Remote Access Denied

Issue: Cannot access dashboard from another machine. Solution:

Set allow-remote: true in config.yaml
Restart the server
Verify firewall allows port 18080

Next Steps

Setup Providers

Configure AI providers through the dashboard

Troubleshooting

Resolve common issues

​Overview

​Accessing the Dashboard

​Configuration

​Enable Management API

​First-Time Setup

​Dashboard Features

​Provider Configuration

​Model Routing

​Real-Time Monitoring

​Provider Health Status

​Performance Analytics

​Memory System Stats

​Live Log Streaming

​Configuration Editor

​Management API Reference

​Monitoring Endpoints

​Operations Endpoints

​Configuration Endpoints

​OAuth Session Management

​View Active Sessions

​Revoke Session

​Feedback and Learning

​Intelligence System Controls

​Cortex Router Status

​Reload Skills

​Hooks and Automation

​List Active Hooks

​Reload Hook Configuration

​Usage Analytics

​Quota Monitoring

​Security Best Practices

​Troubleshooting

​Dashboard Won’t Load

​Authentication Fails

​Remote Access Denied

​Next Steps

Setup Providers

Troubleshooting

Overview

Accessing the Dashboard

Configuration

Enable Management API

First-Time Setup

Dashboard Features

Provider Configuration

Model Routing

Real-Time Monitoring

Provider Health Status

Performance Analytics

Memory System Stats

Live Log Streaming

Configuration Editor

Management API Reference

Monitoring Endpoints

Operations Endpoints

Configuration Endpoints

OAuth Session Management

View Active Sessions

Revoke Session

Feedback and Learning

Intelligence System Controls

Cortex Router Status

Reload Skills

Hooks and Automation

List Active Hooks

Reload Hook Configuration

Usage Analytics

Quota Monitoring

Security Best Practices

Troubleshooting

Dashboard Won’t Load

Authentication Fails

Remote Access Denied

Next Steps