CLI Reference
vibecontrols from @vibecontrols/cli. The agent's separate vibe binary (from @vibecontrols/agent) has its own commands — see below.
Install
npm install -g @vibecontrols/cli
Top-level command groups
| Group | What |
|---|---|
auth | Authentication (login, logout, status, token, refresh) |
workspace | Workspace context (list, current, set) |
agents | Agent management (list, show, rotate-api-key, etc.) |
vibes | Vibe CRUD (create, list, show, update, archive, delete) |
sessions | Sessions (create, list, send-command, send-keys, share, terminate) |
notes | Notes (create, list, show, update, pin, delete) |
config | Backend configuration (get, set, delete, list, bulk) |
webhooks | Webhooks (create, list, update, delete, deliveries) |
tunnels | Tunnel management (create, list, delete) |
targets | Targets — SSH/RDP/VNC connection destinations (create, list, update, delete, test) |
vibedeck | VibeDecks (create, add-button, list, share, etc.) |
ai-tool-events | AI tool event tracking (list, query) |
docs | Docs sites (create-site, list-sites, etc.) |
audit | Audit log (list, filter) |
ui-session | UI state persistence |
cli-config | CLI local settings |
backup | Backup (create, list, restore) — when the backup plugin is installed |
Common examples
# Auth
vibecontrols auth login
vibecontrols auth status
vibecontrols auth token --workspace
# Workspace
vibecontrols workspace list
vibecontrols workspace set <id>
# Agents
vibecontrols agents list --active
vibecontrols agents show <id>
vibecontrols agents rotate-api-key <id>
# Vibes
vibecontrols vibes create --name my-api --path /home/me/code/my-api --type REPOSITORY
vibecontrols vibes list
vibecontrols vibes show <id>
# Sessions
vibecontrols sessions create --name dev --vibe-id <vid> --agent <aid> --type TMUX --command "bun run dev"
vibecontrols sessions list --status RUNNING
vibecontrols sessions send-command <sid> "git pull"
vibecontrols sessions terminate <sid>
# Targets
vibecontrols targets create --name prod-server --type SSH --host 10.0.1.5 --port 22 --username deploy
# VibeDecks
vibecontrols vibedeck create --name "Dev Commands" --grid-columns 4 --grid-rows 4
vibecontrols vibedeck add-button <did> --row 0 --column 0 --label Build --action-type COMMAND --command "bun run build"
# Webhooks
vibecontrols webhooks create --name slack --url https://hooks.slack.com/... --events "session.started,session.terminated"
# Audit
vibecontrols audit list --action CREATE --resource-type AGENT --since 24h
Each command's full flag list is in vibecontrols <group> <subcommand> --help.
Agent CLI (vibe from @vibecontrols/agent)
The agent has its own binary for runtime management:
| Command | What |
|---|---|
vibe start [--foreground] [--profile <name>] [-p <port>] | Start the agent |
vibe stop | Stop the agent |
vibe restart | Restart |
vibe status | Show all profile instances + their status |
vibe health | HTTP health probe on the local port |
vibe setup | Auto-install system deps (tmux, ttyd, cloudflared) |
vibe autostart install | Daemonize (systemd / launchd / Task Scheduler) |
vibe autostart uninstall | Remove daemon |