AI Integration

Voxeltron has a built-in AI panel powered by Crush (Charmbracelet's AI toolkit). Hit ctrl+a in the TUI and ask your AI anything about your infrastructure. It can see your logs, config, and deploy history — and it can actually take action.

The AI runs in an agentic mode: it can propose and execute actions (deploy, rollback, scale, rotate certs) with your confirmation on each step. Think of it as a DevOps engineer that lives in your terminal and never needs a coffee break.

Supported Models

Claude 3.5 Sonnet

Anthropic

Recommended — best reasoning

GPT-4o

OpenAI

Strong alternative

Gemini 1.5 Pro

Google

Large context window

Ollama (local)

Self-hosted

No API key needed, runs locally

Configure the AI Panel

$ voxeltron ai configure

? Provider: Anthropic
? API key: (hidden input)
? Model: claude-3-5-sonnet-20241022
? Max tokens per request: 4096

✓ AI configured. Press ctrl+a in the TUI to open the panel.

Or edit the config file directly:

# ~/.config/voxeltron/config.toml
[ai]
provider = "anthropic"
model = "claude-3-5-sonnet-20241022"
api_key_env = "ANTHROPIC_API_KEY"  # reads from env var
max_tokens = 4096
agentic = true

Using the AI Panel

In the TUI, press ctrl+a. The panel opens with context already loaded:

┌─ Voxeltron AI ────────────────────────────────────────────┐
│ Context loaded:                                           │
│   • web-app: last 50 log lines                            │
│   • web-app: config, env vars (values redacted), health   │
│   • Deploy history: last 5 deploys                        │
│                                                           │
│ > _                                                       │
└───────────────────────────────────────────────────────────┘

Example queries

why is web-app using so much memory?
show me errors from the last hour
roll back to yesterday's deploy
add a health check endpoint and redeploy
my postgres is slow — check the logs and suggest indexes
rotate the TLS cert for api.example.com

Agentic actions

When the AI wants to take action, it asks for confirmation:

AI: I can see web-app has been OOMing every 4h.
    The memory limit is 256MB but the Node.js heap
    is growing to 280MB before the OOM killer hits.

    I recommend increasing the memory limit to 512MB
    and adding --max-old-space-size=400 to NODE_OPTIONS.

    Proposed action:
      voxeltron service update web-app --memory 512mb
      voxeltron env set web-app NODE_OPTIONS="--max-old-space-size=400"
      voxeltron redeploy web-app

    Execute these 3 actions? [y/N]: y

✓ Memory limit updated
✓ Environment variable set
✓ Zero-downtime redeploy complete

The AI never takes action without your explicit y confirmation. Each proposed action is shown clearly before execution. You can review and reject individual steps.

BYOK vs Cloud Quota

You can always bring your own API key (BYOK) — the AI panel works entirely on the client side. Pro and Teams plans also include a monthly token quota via Voxeltron Cloud if you don't want to manage keys:

# Use your own key (free, unlimited)
$ ANTHROPIC_API_KEY=sk-... voxeltron

# Use Voxeltron Cloud quota (Pro/Teams)
$ voxeltron ai auth login  # authenticates with Voxeltron Cloud