Commands Overview¶
Many of these operations also have UI equivalents in the desktop app and web console (service control, backend and model selection, settings) and in the iOS app (threads, approvals, voice). The CLI is the layer underneath all of them.
Openbase CLI command structure:
Global Options¶
| Option | Description |
|---|---|
--version |
Print CLI version and exit |
--help |
Show help |
Top-Level Commands¶
| Command | Description |
|---|---|
backend |
View or switch the selected coding backend |
claude |
Manage Openbase's Claude Code auth |
claude-sync |
Synchronize Claude Code sessions between normal and Openbase config homes |
defaults |
Manage default dispatcher and Super Agents model/reasoning settings |
setup |
Full local bootstrap flow |
server |
Run local Django/ASGI server |
restart |
Restart Openbase-managed services |
self-update |
Update a standalone install to the latest release |
version |
Print CLI and package versions plus update availability |
services |
Manage launchd services |
doctor |
Verify install, service health, and secrets |
onboarding |
Inspect onboarding state and report it to Openbase cloud |
login |
Email-code login to Openbase cloud |
logout |
Remove saved auth tokens |
plugins |
Install and manage Openbase plugins |
bootstrap |
Run plugin-provided bootstrap commands |
voice routing |
Route the active LiveKit voice room between the dispatcher and Super Agents |
Common Examples¶
# Full bootstrap
openbase-coder setup
# Start API server
openbase-coder server --host 0.0.0.0 --port 7999
# Check service states
openbase-coder services status
# Switch coding backend
openbase-coder backend use codex
# Restart Openbase-managed services
openbase-coder restart
# Check or change the active voice route
openbase-coder user voice-route
openbase-coder user transfer-to-agent "Lucy"
openbase-coder exit-to-dispatch
# Tail logs for one service
openbase-coder services logs django-cli
# Validate local environment
openbase-coder doctor
# Install plugin from local repo
openbase-coder plugins add ~/code/my-openbase-plugin
# List plugin-provided bootstrappers
openbase-coder plugins bootstrappers
# Run a bootstrapper
openbase-coder bootstrap django-app --params-file bootstrap.json