CLI Commands Reference

Full reference for the vesper CLI.

Global

vesper --help
vesper -q "<message>"                    # run a query with default agent
vesper -q "<message>" -a <mode>          # explicit agent
vesper -q "/status"                      # slash commands work too

agent

vesper agent list                        # installed agents
vesper agent list --all                  # + bundled
vesper agent registry                    # full catalog
vesper agent search <query>              # match name/tag/description
vesper agent show <mode>                 # detail view
vesper agent install <mode>              # copy bundled → user dir
vesper agent uninstall <mode>            # remove user-installed
vesper agent start <mode>                # set default
vesper agent stop                        # revert to "auto"
vesper agent run <mode> "<msg>"          # one-off run
vesper agent create <mode>               # scaffold new agent

gateway

vesper gateway start                     # foreground
vesper gateway start --detach            # background
vesper gateway stop
vesper gateway status
vesper gateway logs --lines 100

memory

vesper memory write <agent> "<content>" [--tag X --ttl-hours N]
vesper memory list <agent> [--tag X] [--json]
vesper memory search <agent> "<query>"
vesper memory delete <agent> <id>
vesper memory clear <agent>
vesper memory stats                      # workspace-wide
vesper memory compact                    # workspace-wide

plugin

vesper plugin list                       # installed plugins
vesper plugin list --all                 # + bundled
vesper plugin info <name>
vesper plugin install <path>             # local plugin dir
vesper plugin uninstall <name>
vesper plugin search <query>

oauth

vesper oauth login <provider> --client-id <id> [--client-secret <s>] [--scopes a,b,c]
vesper oauth list
vesper oauth logout <provider>

skill

vesper skill list [--source bundled|user] [--json]
vesper skill install <path>              # local SKILL.md path or dir

cron

vesper cron list                         # heartbeat-enabled agents
vesper cron status
vesper cron reload                       # re-scan .agents/

doctor

vesper doctor                            # health checks: API keys, agents, plugins

workspace

vesper workspace list
vesper workspace create <name>
vesper workspace remove <name>

Slash commands (work inside -q)

See Slash Commands.