Skip to main content

Commands

Local CLI

Service lifecycle

CommandWhat it does
vibeStart Avibe and open the local Web UI
vibe statusShow local service and configuration status
vibe restartRestart all services
vibe restart --delay-seconds NRestart N seconds from now so an active conversation can reply first
vibe stopStop the local Avibe service
vibe doctorRun diagnostics for common setup issues
vibe versionPrint the installed version

Remote Web UI

CommandWhat it does
vibe remoteGuided sign-in and pairing for the avibe.bot tunnel
vibe remote pair <key>Pair using a one-time key copied from avibe.bot
vibe remote statusShow pairing and tunnel state (add --json for machine output)
vibe remote startStart the cloudflared tunnel after pairing
vibe remote stopStop the tunnel without removing the pairing

Updates

CommandWhat it does
vibe check-updateCheck if a newer release is available
vibe upgradeUpgrade Avibe to the latest release

Utilities

CommandWhat it does
vibe screenshotCapture the local desktop to a PNG file

Agent Harness

CommandWhat it does
vibe agent runRun one Agent job now; add --async for one-shot background work, or --fork-session to branch from an existing Session
vibe runs list / show / cancelInspect and manage concrete Agent Run records
vibe task addSave a recurring or one-off time trigger that creates Agent Runs later
vibe task listList saved tasks (use --brief or --all)
vibe task show / update / pause / resume / run / removeManage one saved task
vibe watch addRun a managed waiter that creates a follow-up Agent Run when it succeeds
vibe watch list / show / pause / resume / removeManage one watch
Together these commands form the Avibe Harness. A user can ask their agent to watch a PR, wait for CI, schedule a daily status check, start a separate investigation session, or fan out background checks. The agent can combine the primitives without making the user memorize every flag. Each subcommand accepts --help for the full argument list, including --session-id, --fork-session, --post-to, --deliver-key, --message, --message-file, --cron, --at, --async, and --timezone where applicable. Use vibe agent run --fork-session <session-id> --message "..." when a new Agent Session should branch from an existing Session’s native backend context. The fork keeps the source backend. --agent, --model, and --reasoning-effort may override the forked Session only when the Agent backend does not change.

Chat usage

In chatWhat it does
Mention the botStart a task or ask a question
Reply in threadContinue the same agent session
/stopStop the current session where supported
Plain message in enabled scopeSend work to the configured agent