The all-new Voyager Code extension is here, rebuilt on the Voyager CLI for speed, flexibility, and continued access to 500+ models via the Voyager Gateway →
CLI Command Reference
voyager acp
start ACP (Agent Client Protocol) server
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
--cwd working directory [string] [default: "."]
voyager mcp
manage MCP (Model Context Protocol) servers
Commands:
voyager mcp add [name] add an MCP server
voyager mcp list list MCP servers and their status [aliases: ls]
voyager mcp auth [name] authenticate with an OAuth-enabled MCP server
voyager mcp logout [name] remove OAuth credentials for an MCP server
voyager mcp debug <name> debug OAuth connection for an MCP server
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager mcp add
add an MCP server
Positionals:
name name of the MCP server [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--url URL for a remote MCP server [string]
--env environment variable for a local MCP server (KEY=VALUE) [array]
--header HTTP header for a remote MCP server (KEY=VALUE) [array]
voyager mcp list
list MCP servers and their status
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager mcp auth
authenticate with an OAuth-enabled MCP server
Commands:
voyager mcp auth list list OAuth-capable MCP servers and their auth status [aliases: ls]
Positionals:
name name of the MCP server [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager mcp auth list
list OAuth-capable MCP servers and their auth status
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager mcp logout
remove OAuth credentials for an MCP server
Positionals:
name name of the MCP server [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager mcp debug
debug OAuth connection for an MCP server
Positionals:
name name of the MCP server [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager [project]
start voyager tui
Positionals:
project path to start voyager in [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
-m, --model model to use in the format of provider/model [string]
-c, --continue continue the last session [boolean]
-s, --session session id to continue [string]
--fork fork the session when continuing (use with --continue or --session) [boolean]
--cloud-fork fetch session from cloud and continue locally (use with --session) [boolean]
--prompt prompt to use [string]
--agent agent to use [string]
voyager attach
attach to a running voyager server
Positionals:
url http://localhost:4096 [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--dir directory to run in [string]
-c, --continue continue the last session [boolean]
-s, --session session id to continue [string]
--fork fork the session when continuing (use with --continue or --session) [boolean]
--cloud-fork fetch session from cloud and continue locally (use with --session) [boolean]
-p, --password basic auth password (defaults to VOYAGER_SERVER_PASSWORD) [string]
-u, --username basic auth username (defaults to VOYAGER_SERVER_USERNAME or 'voyager') [string]
voyager run
run voyager with a message
Positionals:
message message to send [string] [default: []]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--command the command to run, use message for args [string]
-c, --continue continue the last session [boolean]
-s, --session session id to continue [string]
--fork fork the session before continuing (requires --continue or --session) [boolean]
--cloud-fork fetch session from cloud and continue locally (use with --session) [boolean]
--share share the session [boolean]
-m, --model model to use in the format of provider/model [string]
--agent agent to use [string]
--format format: default (formatted) or json (raw JSON events) [string] [choices: "default", "json"] [default: "default"]
-f, --file file(s) to attach to message [array]
--title title for the session (uses truncated prompt if no value provided) [string]
--attach attach to a running voyager server (e.g., http://localhost:4096) [string]
-p, --password basic auth password (defaults to VOYAGER_SERVER_PASSWORD) [string]
-u, --username basic auth username (defaults to VOYAGER_SERVER_USERNAME or 'voyager') [string]
--dir directory to run in, path on remote server if attaching [string]
--port port for the local server (defaults to random port if no value provided) [number]
--variant model variant (provider-specific reasoning effort, e.g., high, max, minimal) [string]
--thinking show thinking blocks [boolean]
--replay replay interactive session history on resume and after resize (use --no-replay to disable) [boolean] [default: true]
--replay-limit cap visible interactive replay to the newest N messages [number]
-i, --interactive run in direct interactive split-footer mode [boolean] [default: false]
--dangerously-skip-permissions auto-approve permissions that are not explicitly denied (dangerous!) [boolean] [default: false]
--auto auto-approve all permissions (for autonomous/pipeline usage) [boolean] [default: false]
--demo enable direct interactive demo slash commands; pass one as the message to run it immediately [boolean] [default: false]
voyager debug
debugging and troubleshooting tools
Commands:
voyager debug config show resolved configuration
voyager debug lsp LSP debugging utilities
voyager debug rg ripgrep debugging utilities
voyager debug file file system debugging utilities
voyager debug scrap list all known projects
voyager debug skill list all available skills
voyager debug snapshot snapshot debugging utilities
voyager debug startup print startup timing
voyager debug agent <name> show agent configuration details
voyager debug v2 debug v2 catalog and built-in plugins
voyager debug info show debug information
voyager debug paths show global paths (data, config, cache, state)
voyager debug wait wait indefinitely (for debugging)
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug config
show resolved configuration
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug lsp
LSP debugging utilities
Commands:
voyager debug lsp diagnostics <file> get diagnostics for a file
voyager debug lsp symbols <query> search workspace symbols
voyager debug lsp document-symbols <uri> get symbols from a document
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug lsp diagnostics
get diagnostics for a file
Positionals:
file [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug lsp symbols
search workspace symbols
Positionals:
query [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug lsp document-symbols
get symbols from a document
Positionals:
uri [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug rg
ripgrep debugging utilities
Commands:
voyager debug rg files list files using ripgrep
voyager debug rg search <pattern> search file contents using ripgrep
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug rg files
list files using ripgrep
Options:
--help Show help [boolean]
--version Show version number [boolean]
--query Filter files by query [string]
--glob Glob pattern to match files [string]
--limit Limit number of results [number]
voyager debug rg search
search file contents using ripgrep
Positionals:
pattern Search pattern [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--glob File glob patterns [array]
--limit Limit number of results [number]
voyager debug file
file system debugging utilities
Commands:
voyager debug file read <path> read file contents as JSON
voyager debug file list <path> list files in a directory
voyager debug file search <query> search files by query
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug file read
read file contents as JSON
Positionals:
path File path to read [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug file list
list files in a directory
Positionals:
path File path to list [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug file search
search files by query
Positionals:
query Search query [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug scrap
list all known projects
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug skill
list all available skills
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug snapshot
snapshot debugging utilities
Commands:
voyager debug snapshot track track current snapshot state
voyager debug snapshot patch <hash> show patch for a snapshot hash
voyager debug snapshot diff <hash> show diff for a snapshot hash
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug snapshot track
track current snapshot state
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug snapshot patch
show patch for a snapshot hash
Positionals:
hash hash [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug snapshot diff
show diff for a snapshot hash
Positionals:
hash hash [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug startup
print startup timing
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug agent
show agent configuration details
Positionals:
name Agent name [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--tool Tool id to execute [string]
--params Tool params as JSON or a JS object literal [string]
voyager debug v2
debug v2 catalog and built-in plugins
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug info
show debug information
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug paths
show global paths (data, config, cache, state)
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager debug wait
wait indefinitely (for debugging)
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager auth
manage AI providers and credentials
Commands:
voyager auth list list providers and credentials [aliases: ls]
voyager auth login [url] log in to a provider
voyager auth logout [provider] log out from a configured provider
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager auth list
list providers and credentials
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager auth login
log in to a provider
Positionals:
url voyager auth provider [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
-p, --provider provider id or name to log in to (skips provider selection) [string]
-m, --method login method label (skips method selection) [string]
voyager auth logout
log out from a configured provider
Positionals:
provider provider id or name to log out from [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager agent
manage agents
Commands:
voyager agent create create a new agent
voyager agent list list all available agents
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager agent create
create a new agent
Options:
--help Show help [boolean]
--version Show version number [boolean]
--path directory path to generate the agent file [string]
--description what the agent should do [string]
--mode agent mode [string] [choices: "all", "primary", "subagent"]
--permissions, --tools comma-separated list of permissions to allow (default: all). Available: "bash, read, edit, glob, grep, webfetch, task, todowrite, websearch, lsp, skill" [string]
-m, --model model to use in the format of provider/model [string]
voyager agent list
list all available agents
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager upgrade
upgrade voyager to the latest or a specific version
Positionals:
target version to upgrade to, for ex '0.1.48' or 'v0.1.48' [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
-m, --method installation method to use [string] [choices: "curl", "npm", "yarn", "pnpm", "bun", "brew", "choco", "scoop"]
voyager uninstall
uninstall voyager and remove all related files
Options:
--help Show help [boolean]
--version Show version number [boolean]
-c, --keep-config keep configuration files [boolean] [default: false]
-d, --keep-data keep session data and snapshots [boolean] [default: false]
--dry-run show what would be removed without removing [boolean] [default: false]
-f, --force skip confirmation prompts [boolean] [default: false]
voyager serve
starts a headless voyager server
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
voyager web
start voyager server and open web interface
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
voyager models
list all available models
Positionals:
provider provider ID to filter models by [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--verbose use more verbose model output (includes metadata like costs) [boolean]
--refresh refresh the models cache from models.dev [boolean]
voyager roll-call
batch-test text models matching a filter for connectivity and latency
Positionals:
filter regex to filter models by provider/modelID (required) [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--prompt Prompt to send to each model [string] [default: "Hello"]
--timeout Timeout for each model call in milliseconds [number] [default: 25000]
--parallel Number of parallel model calls [number] [default: 5]
--verbose Show verbose output [boolean] [default: false]
--quiet Suppress progress and decoration [boolean] [default: false]
--output Output format (table, json, or md) [string] [choices: "table", "json", "md"] [default: "table"]
voyager profile
show Voyager account profile
Options:
--help Show help [boolean]
--version Show version number [boolean]
--json output profile as JSON [boolean] [default: false]
voyager stats
show token usage and cost statistics
Options:
--help Show help [boolean]
--version Show version number [boolean]
--days show stats for the last N days (default: all time) [number]
--tools number of tools to show (default: all) [number]
--models show model statistics (default: hidden). Pass a number to show top N, otherwise shows all
--project filter by project (default: all projects, empty string: current project) [string]
voyager export
export session data as JSON
Positionals:
sessionID session id to export [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--sanitize redact sensitive transcript and file data [boolean]
voyager import
import session data from JSON file or URL
Positionals:
file path to JSON file or share URL [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager github
manage GitHub agent
Commands:
voyager github install install the GitHub agent
voyager github run run the GitHub agent
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager github install
install the GitHub agent
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager github run
run the GitHub agent
Options:
--help Show help [boolean]
--version Show version number [boolean]
--event GitHub mock event to run the agent for [string]
--token GitHub personal access token (github_pat_********) [string]
voyager pr
fetch and checkout a GitHub PR branch, then run voyager
Positionals:
number PR number to checkout [number]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager session
manage sessions
Commands:
voyager session list list sessions
voyager session delete <sessionID> delete a session
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager session list
list sessions
Options:
--help Show help [boolean]
--version Show version number [boolean]
-n, --max-count limit to N most recent sessions [number]
--format output format [string] [choices: "table", "json"] [default: "table"]
-a, --all list sessions from all projects [boolean] [default: false]
-s, --search filter sessions by title [string]
voyager session delete
delete a session
Positionals:
sessionID session ID to delete [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager remote
enable remote connection for real-time session relay
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager daemon
manage the local voyager daemon
Commands:
voyager daemon start the local voyager daemon [default]
voyager daemon start start the local voyager daemon
voyager daemon status show local voyager daemon status
voyager daemon stop stop the local voyager daemon
voyager daemon restart restart the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
--json print daemon details as JSON [boolean]
-f, --foreground keep the command active until interrupted [boolean]
voyager daemon start
start the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
--json print daemon details as JSON [boolean]
-f, --foreground keep the command active until interrupted [boolean]
voyager daemon status
show local voyager daemon status
Options:
--help Show help [boolean]
--version Show version number [boolean]
--json print daemon details as JSON [boolean]
voyager daemon stop
stop the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--json print daemon details as JSON [boolean]
voyager daemon restart
restart the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
--json print daemon details as JSON [boolean]
-f, --foreground keep the command active until interrupted [boolean]
voyager console
open or stop the local Voyager Console (deprecated)
Commands:
voyager console open the local Voyager Console (deprecated) [default]
voyager console stop stop the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--port port to listen on [number] [default: 0]
--hostname hostname to listen on [string] [default: "127.0.0.1"]
--mdns enable mDNS service discovery (defaults hostname to 0.0.0.0) [boolean] [default: false]
--mdns-domain custom domain name for mDNS service (default: voyager.local) [string] [default: "voyager.local"]
--cors additional domains to allow for CORS [array] [default: []]
-f, --foreground keep the command active until interrupted [boolean]
voyager console stop
stop the local voyager daemon
Options:
--help Show help [boolean]
--version Show version number [boolean]
--json print daemon details as JSON [boolean]
voyager cloud
run Cloud Agent tasks
Commands:
voyager cloud start start a Cloud Agent task
voyager cloud send send a follow-up prompt to a Cloud Agent task
voyager cloud status show Cloud Agent task status
voyager cloud result show a Cloud Agent task result
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager cloud start
start a Cloud Agent task
Options:
--help Show help [boolean]
--version Show version number [boolean]
--prompt prompt for the Cloud Agent [string] [required]
--repo repository shorthand or URL [string]
--repo-type repository provider type [string] [choices: "github", "gitlab", "git"]
--branch repository branch [string]
--model Cloud Agent model [string]
--mode Cloud Agent mode [string]
--org-id Voyager organization ID [string]
--stream connect to the WebSocket stream and print events as JSONL [boolean]
voyager cloud send
send a follow-up prompt to a Cloud Agent task
Options:
--help Show help [boolean]
--version Show version number [boolean]
--session-id Cloud Agent session ID [string] [required]
--prompt follow-up prompt for the Cloud Agent [string] [required]
voyager cloud status
show Cloud Agent task status
Options:
--help Show help [boolean]
--version Show version number [boolean]
--session-id Cloud Agent session ID [string] [required]
--message-id Cloud Agent message ID [string] [required]
voyager cloud result
show a Cloud Agent task result
Options:
--help Show help [boolean]
--version Show version number [boolean]
--session-id Cloud Agent session ID [string] [required]
--message-id Cloud Agent message ID [string] [required]
voyager db
database tools
Commands:
voyager db [query] open an interactive sqlite3 shell or run a query [default]
voyager db path print the database path
Positionals:
query SQL query to execute [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--format Output format [string] [choices: "json", "tsv"] [default: "tsv"]
voyager db path
print the database path
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager config
configuration tools
Commands:
voyager config check check configuration for warnings and errors
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager config check
check configuration for warnings and errors
Options:
--help Show help [boolean]
--version Show version number [boolean]
voyager plugin
install plugin and update config
Positionals:
module npm module name [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
-g, --global install in global config [boolean] [default: false]
-f, --force replace existing plugin version [boolean] [default: false]
voyager help
show full CLI reference
Positionals:
command command to show help for [string]
Options:
--help Show help [boolean]
--version Show version number [boolean]
--all show help for all commands [boolean] [default: false]
--format output format [string] [choices: "md", "text"] [default: "md"]
voyager completion
generate shell completion script
Options:
--help Show help [boolean]
--version Show version number [boolean]