Skip to content

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:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

agy

Alias for vp run agy.

Usage:

vp agy [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

attach

Reattach your terminal to a running VibePod-managed container.

Use this to rejoin an agent session after the terminal that started it was closed. Find candidate containers with vp list.

Usage:

vp attach [OPTIONS] [container]

Options:

  container  Container name or ID to attach to (see `vp list`). Omit when
             exactly one managed container is running.

auggie

Alias for vp run auggie.

Usage:

vp auggie [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

c

Alias for vp run claude.

Usage:

vp c [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

claude

Alias for vp run claude.

Usage:

vp claude [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

codex

Alias for vp run codex.

Usage:

vp codex [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

config

Manage configuration

Usage:

vp config [OPTIONS] COMMAND [ARGS]...
allow-dir

Add a directory to the vp run allow list.

Usage:

vp config allow-dir [OPTIONS] [directory]

Options:

  directory  Directory to allow (defaults to current directory)
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
list-allowed-dirs

List all directories in the vp run allow list.

Usage:

vp config list-allowed-dirs [OPTIONS]
path

Show configuration, logs, and proxy database paths.

Usage:

vp config path [OPTIONS]

Options:

  --global   Show global config path only
  --project  Show project config path only
remove-dir

Remove a directory from the vp run allow list.

Usage:

vp config remove-dir [OPTIONS] [directory]

Options:

  directory  Directory to remove (defaults to current directory)
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:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

d

Alias for vp run devstral.

Usage:

vp d [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

devstral

Alias for vp run devstral.

Usage:

vp devstral [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

doctor

Inspect agent auth and config state

Usage:

vp doctor [OPTIONS] COMMAND [ARGS]...
claude

Inspect Claude Code credential state for diagnosing auth/refresh issues.

Usage:

vp doctor claude [OPTIONS]

Options:

  --profile <str>  Credential profile to inspect (see `vp profile list`)
herdr

Diagnose herdr terminal-multiplexer wiring end to end.

Run this INSIDE a herdr pane. Without an agent: passive summary of every agent's integration state. With an agent: checks pane env, socket, binary, the injected integration files, the hook trace log, performs a live host-side state report, and (when Docker is available) reproduces the exact in-container herdr call.

Usage:

vp doctor herdr [OPTIONS] [agent]

Options:

  agent            Agent to inspect in depth; omit for an all-agents summary
  --profile <str>  Credential profile to inspect (see `vp profile list`)

ds

Alias for vp run dsh.

Usage:

vp ds [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

dsh

Alias for vp run dsh.

Usage:

vp dsh [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

fb

Alias for vp run freebuff.

Usage:

vp fb [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

freebuff

Alias for vp run freebuff.

Usage:

vp freebuff [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

g

Alias for vp run gemini.

Usage:

vp g [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

gemini

Alias for vp run gemini.

Usage:

vp gemini [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

j

Alias for vp run jcode.

Usage:

vp j [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

jcode

Alias for vp run jcode.

Usage:

vp jcode [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

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 <int>  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 <int>  Datasette host port
  --no-open     Do not open browser

n

Alias for vp run agy.

Usage:

vp n [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

o

Alias for vp run opencode.

Usage:

vp o [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

opencode

Alias for vp run opencode.

Usage:

vp opencode [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

p

Alias for vp run copilot.

Usage:

vp p [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

pi

Alias for vp run pi.

Usage:

vp pi [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

profile

Manage credential profiles (separate agent logins per environment)

Usage:

vp profile [OPTIONS] COMMAND [ARGS]...
create

Create a new empty profile.

Usage:

vp profile create [OPTIONS] {name}

Options:

  name    Profile name (lowercase slug)  [required]
list

List profiles, the active one, and which agents have stored data.

Usage:

vp profile list [OPTIONS]
remove

Remove a profile and its stored credentials.

Usage:

vp profile remove [OPTIONS] {name}

Options:

  name       Profile to remove  [required]
  -y, --yes  Skip confirmation

proxy

Manage the HTTP(S) proxy

Usage:

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

Manage proxy allow/deny filtering

Usage:

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

Manage the allow list

Usage:

vp proxy filter allow [OPTIONS] COMMAND [ARGS]...
# add

Add a host pattern to the allow list.

Usage:

vp proxy filter allow add [OPTIONS] {host}

Options:

  host             Host pattern  [required]
  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
# remove

Remove a host pattern from the allow list.

Usage:

vp proxy filter allow remove [OPTIONS] {host}

Options:

  host             Host pattern  [required]
  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
deny

Manage the deny list

Usage:

vp proxy filter deny [OPTIONS] COMMAND [ARGS]...
# add

Add a host pattern to the deny list.

Usage:

vp proxy filter deny add [OPTIONS] {host}

Options:

  host             Host pattern  [required]
  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
# remove

Remove a host pattern from the deny list.

Usage:

vp proxy filter deny remove [OPTIONS] {host}

Options:

  host             Host pattern  [required]
  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
mode

Set the filter mode (open = no filtering).

Usage:

vp proxy filter mode [OPTIONS] {value}

Options:

  value            open, allow, or deny  [required]
  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
status

Show filter mode, lists, and proxy state.

Usage:

vp proxy filter status [OPTIONS]

Options:

  --profile <str>  Profile whose filter to manage (default: the active
                   profile)
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

q

Alias for vp run qwen.

Usage:

vp q [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

qwen

Alias for vp run qwen.

Usage:

vp qwen [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

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
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

skills

Manage VibePod skills

Usage:

vp skills [OPTIONS] COMMAND [ARGS]...
add

Install a skill from a locator.

Usage:

vp skills add [OPTIONS] {locator}

Options:

  locator        Skill locator (github:..., npm:..., ./path, ...)  [required]
  --id <str>     Override the derived skill ID
  --scope <str>  local|user (defaults to local inside a project, else user)
  --link         Symlink instead of copy (local sources only)
  --json         Emit JSON to stdout
delete

Remove an installed skill.

Usage:

vp skills delete [OPTIONS] {skill_id}

Options:

  skill_id       Skill ID to remove  [required]
  --scope <str>  local|user
  --json
list

List installed skills across both scopes.

Usage:

vp skills list [OPTIONS]

Options:

  --scope <str>  Filter by scope (local|user)
  --json
sync

Reconcile installed/ with the lockfile (no re-resolve).

Usage:

vp skills sync [OPTIONS]

Options:

  --scope <str>  local|user
  --json
update

Re-resolve locators and rewrite the lockfile.

Usage:

vp skills update [OPTIONS] [skill_id]

Options:

  skill_id       Skill ID (omit to update all)
  --scope <str>  local|user
  --json

stop

Stop an agent's containers, a specific container, or all managed containers.

Usage:

vp stop [OPTIONS] [target]

Options:

  target       Agent name/shortcut (stops all its containers) or a container
               name or ID from `vp list` (stops just that container).
  -a, --all    Stop all VibePod managed containers
  -f, --force  Force stop

t

Alias for vp run tau.

Usage:

vp t [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

task

Create and manage headless background agent tasks

Usage:

vp task [OPTIONS] COMMAND [ARGS]...
_watch-timeout

Internal helper launched by vp task create --timeout.

Usage:

vp task _watch-timeout [OPTIONS] {task_id} {timeout_seconds}

Options:

  task_id          Task id to enforce  [required]
  timeout_seconds  Timeout in seconds  [required]
cancel

Gracefully stop a running task while keeping its record and logs.

Usage:

vp task cancel [OPTIONS] {task_id}

Options:

  task_id  Task id (full or prefix)  [required]
create

Start an agent task in the background and print its id.

Usage:

vp task create [OPTIONS] {agent} {prompt}

Options:

  agent                   Agent to run headlessly  [required]
  prompt                  Prompt to send to the agent  [required]
  -w, --workspace <path>  Workspace directory  [default: .]
  -e, --env <str>         Environment variable KEY=VALUE
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --timeout <str>         Maximum task runtime before graceful stop. Use s/m/h
                          suffixes, or 'none' to opt out.  [default: 2h]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  --ikwid                 I Know What I'm Doing: enable auto-approval flags
                          for supported agents
  --profile <str>         Credential profile to use (see `vp profile list`)
list

List recent tasks with container status.

Usage:

vp task list [OPTIONS]

Options:

  --agent <str>  Filter by agent name
  --json         Output JSON
  --limit <int>  Max rows to show  [default: 20]
logs

Print the agent's stdout/stderr for a task.

Usage:

vp task logs [OPTIONS] {task_id}

Options:

  task_id       Task id (full or prefix)  [required]
  -f, --follow  Stream logs as they are written
rm

Remove one task, or all tasks with --all.

Usage:

vp task rm [OPTIONS] [task_id]

Options:

  task_id      Task id (full or prefix); omit when using --all
  --all        Remove all task records and their containers
  -f, --force  Kill a running container before removing
run

Deprecated alias for task create.

Usage:

vp task run [OPTIONS] {agent} {prompt}

Options:

  agent                   Agent to run headlessly  [required]
  prompt                  Prompt to send to the agent  [required]
  -w, --workspace <path>  Workspace directory  [default: .]
  -e, --env <str>         Environment variable KEY=VALUE
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --timeout <str>         Maximum task runtime before graceful stop. Use s/m/h
                          suffixes, or 'none' to opt out.  [default: 2h]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  --ikwid                 I Know What I'm Doing: enable auto-approval flags
                          for supported agents
  --profile <str>         Credential profile to use (see `vp profile list`)
status

Show container status and exit code for a task.

Usage:

vp task status [OPTIONS] {task_id}

Options:

  task_id  Task id (full or prefix)  [required]
  --json   Output JSON

tau

Alias for vp run tau.

Usage:

vp tau [OPTIONS]

Options:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)

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:

  -w, --workspace <path>  Workspace directory  [default: .]
  --pull                  Pull latest image before run
  --no-overlay            Skip the project overlay image
  --rebuild-overlay       Force rebuilding the project overlay image
  --no-herdr              Skip herdr terminal-multiplexer wiring
  -d, --detach            Run container in background
  -e, --env <str>         Environment variable KEY=VALUE
  -p, --publish <str>     Publish a container port in `docker run -p` syntax
                          (e.g. 127.0.0.1:3090:3081); replaces configured
                          agents.<agent>.ports for this run
  --name <str>            Custom container name
  --network <str>         Additional Docker network to connect the container
                          to
  --paste-images          Enable image pasting via X11 clipboard (requires
                          DISPLAY to be set)
  --ikwid                 I Know What I'm Doing: enable auto-approval / skip
                          permission prompts
  --profile <str>         Credential profile to use (see `vp profile list`)