Settings

The Cockpit Settings section at /cockpit/settings/ provides a web interface for managing your Reeve configuration — LLM providers, agents, billing, and integrations.

Settings Pages

Models (/cockpit/settings/models)

Manage your LLM provider API keys:

┌─────────────────────────────────────────────┐
│ LLM Providers                                │
│                                              │
│ 🟢 Anthropic       sk-ant-...****           │
│    [Test] [Edit] [Remove]                    │
│                                              │
│ 🟢 OpenAI          sk-...****               │
│    [Test] [Edit] [Remove]                    │
│                                              │
│ ⚪ OpenRouter       Not configured           │
│    [Add Key]                                 │
│                                              │
│ Fallback Chain: Anthropic → OpenAI           │
│ [Drag to reorder]                            │
└─────────────────────────────────────────────┘

Features:

• Add/edit/remove API keys for each provider
• Test before save — Validates the key with a real API call
• Drag-reorder fallback chain — Set priority for model fallback
• Provider cards — Show available models per provider

This uses the auth.profiles.* RPC methods on the gateway.

Agents (/cockpit/settings/agents)

Visual agent management (see Agent Management):

• List all agents with role, model, and status
• Create new agents with role selection
• Edit agent config (model, heartbeat, subagents)
• Health check indicators
• Quick actions (inspect, doctor, delete)

Billing (/cockpit/settings/billing)

Credit balance and tier management:

• Current credit balance
• Purchase credits (Stripe Checkout)
• Transaction history
• Current tier and usage quotas
• Upgrade options

Integrations (/cockpit/settings/integrations)

Quick access to connector status:

• List of all connected/disconnected platforms
• One-click connect for each platform
• Sync status and last sync time

Gateway (/cockpit/settings/gateway)

Advanced gateway configuration:

• Port and hostname settings
• Security settings
• Plugin management
• Debug/logging controls

How Settings Work

The Settings pages communicate with the gateway via JSON-RPC:

Frontend → POST /api/gateway/rpc → Gateway method handler → Config update

Key RPC methods:

• config.get / config.patch — Read/update gateway config
• auth.profiles.list / auth.profiles.set — LLM provider keys
• agents.list / agents.create / agents.update — Agent CRUD

Changes take effect immediately — no gateway restart required for most settings.