Operator Guide · v0.1.9

Your panel, your way

A practical reference for operators running VoxeraOS. Tour the panel, understand the safety defaults, manage the governed queue, and learn how to keep your system running cleanly.

Jump to

What's in this guide

Panel tour

Home health and hygiene tools

See what the operator panel shows you — runtime status at a glance and maintenance tools you can run with confidence.

Read section →

Safety

Safe by default

How VoxeraOS keeps your system protected: approval gates, governed queue execution, isolated execution, and non-destructive operations.

Read section →

Operations

Keeping things clean

Minimal, practical commands for health checks, cleanup, and diagnostics. No flags to memorize — just the essentials.

Read section →

Roadmap

What's shipped and what's next

See what's built in v0.1.9 and the broad direction for what's next.

View roadmap →

Panel tour

What the operator panel shows you

Home

Health at a glance

The panel home gives you an instant summary of your system's runtime status. No commands required — just open the panel.

Runtime status: healthy, degraded, or stopped
Active job count and recent completions
Last error summary if something went wrong
Quick links to pending approvals

Hygiene tools

Maintenance with confidence

Run safe maintenance checks directly from the panel. Preview what would be cleaned up before committing to any changes.

Preview cleanup safely — see what would be removed first
Run consistency checks to catch drift early
View last run results at a glance
Non-destructive by default — preview before any action

Safety model

Safe by default. Always.

Preview before deletion

Every cleanup operation shows you exactly what would be affected before making changes. Nothing is deleted without your explicit confirmation.

Cleanup always runs in preview mode first
Consistency checks are read-only — they never modify state
Clear confirmation required before any destructive action

Boundaries you can trust

Every layer of VoxeraOS enforces boundaries. From input handling to queue governance to execution isolation, safety isn't optional — it's structural.

Approval gates on risky actions — no silent auto-approvals
Isolated execution in rootless containers
Rate-limited panel access to reduce brute-force risk
Structured separation of user content and system instructions

Operations

Essential commands

Health and status

Check your system's health and see what's running.

# Quick health check
voxera queue health

# Live status overview
voxera queue status

# Provider and system diagnostics
voxera doctor

Cleanup and maintenance

Keep your system clean. Preview first, apply when ready.

# Preview cleanup (safe, no changes)
voxera artifacts prune --max-age-days 30

# Apply cleanup after preview
voxera artifacts prune --max-age-days 30 --yes

# Consistency check (read-only)
voxera queue reconcile

Approvals

Review and respond to pending approval requests.

# List pending approvals
voxera queue approvals list

# Approve a specific job
voxera queue approvals approve <job_id>

# Deny a specific job
voxera queue approvals deny <job_id>

Incident support

Package system state for review or handoff.

# Bundle system state
voxera ops bundle system

# Bundle a specific job
voxera ops bundle job <job_id>

What's next

See what's built and what's coming

v0.1.9 includes governed queue execution, approval gates, artifact-backed outcomes, and baseline recovery. This is the most stable release so far.

View Roadmap Feature details