CLI Reference¶

Complete reference for all vp commands, auto-generated from the source.

app¶

VibePod - One CLI for all AI coding agents

Usage:

vp [OPTIONS] COMMAND [ARGS]...

Options:

  --install-completion  Install completion for the current shell.
  --show-completion     Show completion for the current shell, to copy it or
                        customize the installation.

a¶

Alias for vp run auggie.

Usage:

vp a [OPTIONS]

Options:

  --bound-agent TEXT  [default: auggie]

auggie¶

Alias for vp run auggie.

Usage:

vp auggie [OPTIONS]

Options:

  --bound-agent TEXT  [default: auggie]

c¶

Alias for vp run claude.

Usage:

vp c [OPTIONS]

Options:

  --bound-agent TEXT  [default: claude]

claude¶

Alias for vp run claude.

Usage:

vp claude [OPTIONS]

Options:

  --bound-agent TEXT  [default: claude]

codex¶

Alias for vp run codex.

Usage:

vp codex [OPTIONS]

Options:

  --bound-agent TEXT  [default: codex]

config¶

Manage configuration

Usage:

vp config [OPTIONS] COMMAND [ARGS]...

init¶

Create a minimal project config or add a specific agent config.

Usage:

vp config init [OPTIONS] [AGENT]

Options:

  [AGENT]  Optional agent config to copy into project
  --force  Overwrite existing project config if present

path¶

Show config and logs paths.

Usage:

vp config path [OPTIONS]

Options:

  --global   Show global config path only
  --project  Show project config path only

show¶

Show effective merged config.

Usage:

vp config show [OPTIONS]

Options:

  --json  Output as JSON

copilot¶

Alias for vp run copilot.

Usage:

vp copilot [OPTIONS]

Options:

  --bound-agent TEXT  [default: copilot]

d¶

Alias for vp run devstral.

Usage:

vp d [OPTIONS]

Options:

  --bound-agent TEXT  [default: devstral]

devstral¶

Alias for vp run devstral.

Usage:

vp devstral [OPTIONS]

Options:

  --bound-agent TEXT  [default: devstral]

g¶

Alias for vp run gemini.

Usage:

vp g [OPTIONS]

Options:

  --bound-agent TEXT  [default: gemini]

gemini¶

Alias for vp run gemini.

Usage:

vp gemini [OPTIONS]

Options:

  --bound-agent TEXT  [default: gemini]

list¶

List available agents and running containers.

Usage:

vp list [OPTIONS]

Options:

  -r, --running  Show only running agents
  --json         Output JSON

logs¶

View logs and traffic UI

Usage:

vp logs [OPTIONS] COMMAND [ARGS]...

start¶

Start or reuse Datasette for session and proxy logs.

Usage:

vp logs start [OPTIONS]

Options:

  --port INTEGER  Datasette host port
  --no-open       Do not open browser

status¶

Show Datasette container status.

Usage:

vp logs status [OPTIONS]

stop¶

Stop the Datasette container.

Usage:

vp logs stop [OPTIONS]

Options:

  -f, --force  Force stop

ui¶

Alias for vp logs start.

Usage:

vp logs ui [OPTIONS]

Options:

  --port INTEGER  Datasette host port
  --no-open       Do not open browser

o¶

Alias for vp run opencode.

Usage:

vp o [OPTIONS]

Options:

  --bound-agent TEXT  [default: opencode]

opencode¶

Alias for vp run opencode.

Usage:

vp opencode [OPTIONS]

Options:

  --bound-agent TEXT  [default: opencode]

p¶

Alias for vp run copilot.

Usage:

vp p [OPTIONS]

Options:

  --bound-agent TEXT  [default: copilot]

proxy¶

Manage the HTTP(S) proxy

Usage:

vp proxy [OPTIONS] COMMAND [ARGS]...

start¶

Start the proxy container.

Usage:

vp proxy start [OPTIONS]

status¶

Show proxy container status.

Usage:

vp proxy status [OPTIONS]

stop¶

Stop the proxy container.

Usage:

vp proxy stop [OPTIONS]

Options:

  -f, --force  Force stop

run¶

Start an agent container.

Usage:

vp run [OPTIONS] [AGENT]

Options:

  [AGENT]               Agent to run
  -w, --workspace PATH  Workspace directory  [default: .]
  --pull                Pull latest image before run
  -d, --detach          Run container in background
  -e, --env TEXT        Environment variable KEY=VALUE
  --name TEXT           Custom container name
  --network TEXT        Additional Docker network to connect the container to

stop¶

Stop one agent container, or all managed containers.

Usage:

vp stop [OPTIONS] [AGENT]

Options:

  [AGENT]      Agent to stop
  -a, --all    Stop all VibePod managed containers
  -f, --force  Force stop

ui¶

Alias for vp logs start.

Usage:

vp ui [OPTIONS]

version¶

Show version and runtime information.

Usage:

vp version [OPTIONS]

Options:

  --json  Output as JSON

x¶

Alias for vp run codex.

Usage:

vp x [OPTIONS]

Options:

  --bound-agent TEXT  [default: codex]