CLI Command Reference¶

Complete reference for Victor CLI commands.

Global Options¶

victor [OPTIONS] COMMAND [ARGS]

Option	Short	Description
`--version`	`-v`	Show version and exit
`--help`		Show help message

Default Behavior¶

Running victor without a subcommand launches the interactive CLI chat mode.

Core Commands¶

`victor chat`¶

Start an interactive chat session with the AI assistant.

victor chat [OPTIONS] [PROMPT]

Option	Short	Default	Description
`--profile`	`-p`	`default`	Profile name from profiles.yaml
`--provider`		From profile	Override provider (ollama, anthropic, openai, google, etc.)
`--model`	`-m`	From profile	Override model identifier
`--vertical`		`coding`	Domain vertical (coding, research, devops, dataanalysis)
`--mode`		`build`	Agent mode (build, plan, explore)
`--headless`		`False`	Run without prompts, auto-approve safe actions
`--dry-run`		`False`	Preview changes without applying
`--one-shot`		`False`	Exit after completing single request
`--log-events`		`False`	Enable observability logging to JSONL
`--thread-id`			Resume from checkpoint thread ID

Examples:

# Interactive CLI mode with default profile
victor chat

# CLI mode with specific provider
victor chat --provider anthropic --model claude-sonnet-4-20250514

# One-shot mode for automation
victor chat --one-shot --headless "Fix the failing test in test_utils.py"

# Resume from checkpoint
victor chat --thread-id abc123

`victor init`¶

Initialize Victor configuration for a project.

victor init [OPTIONS]

Option	Short	Default	Description
`--force`	`-f`	`False`	Overwrite existing configuration
`--provider`	`-p`	`ollama`	Default provider to configure
`--model`	`-m`		Default model to configure
`--analyze`		`True`	Analyze codebase and generate context file
`--minimal`		`False`	Create minimal configuration without analysis

What it creates:

~/.victor/profiles.yaml - Global profile configuration
.victor/init.md - Project-specific context file

`victor serve`¶

Start Victor as an API server.

victor serve [OPTIONS]

Option	Default	Description
`--host`	`127.0.0.1`	Host to bind to
`--port`	`8000`	Port to listen on
`--reload`	`False`	Enable auto-reload for development
`--workers`	`1`	Number of worker processes
`--api-key`		Require API key for requests

Provider & Model Management¶

`victor providers`¶

List available LLM providers.

victor providers list

Displays all supported providers with their status (configured/not configured).

`victor models`¶

List available models for a provider.

victor models list [OPTIONS]

Option	Short	Default	Description
`--provider`	`-p`	`ollama`	Provider to list models from
`--endpoint`	`-e`		Custom endpoint URL

Supported providers: ollama, lmstudio, llamacpp, vllm, anthropic, openai, google, cerebras, groqcloud

Examples:

victor models list -p ollama
victor models list -p lmstudio -e http://192.168.1.20:1234
victor models list -p anthropic

`victor test-provider`¶

Test provider connectivity and capabilities.

victor test-provider [OPTIONS]

Option	Short	Description
`--provider`	`-p`	Provider to test
`--model`	`-m`	Model to test
`--verbose`	`-v`	Show detailed output

Profile Management¶

`victor profiles`¶

Manage model profiles.

victor profiles COMMAND [OPTIONS]

victor profile is kept as a backward-compatible alias. Prefer
victor profiles in new scripts, docs, and IDE integrations.

`victor profiles list`¶

List all configured profiles.

`victor profiles create`¶

Create a new profile.

victor profiles create NAME [OPTIONS]

Option	Short	Required	Description
`--provider`	`-p`	Yes	Provider name
`--model`	`-m`	Yes	Model identifier
`--temperature`	`-t`	No	Temperature (0.0-2.0), default 0.7
`--max-tokens`		No	Maximum output tokens, default 4096
`--description`	`-d`	No	Profile description

`victor profiles edit`¶

Edit an existing profile.

victor profiles edit NAME [OPTIONS]

`victor profiles delete`¶

Delete a profile.

victor profiles delete NAME [--force]

`victor profiles show`¶

Show details of a specific profile.

victor profiles show NAME

`victor profiles set-default`¶

Set a profile as the default.

victor profiles set-default NAME

API Key Management¶

`victor keys`¶

Manage API keys for cloud providers and external services.

victor keys [OPTIONS]

Option	Short	Description
`--setup`	`-s`	Create API keys template file
`--list`	`-l`	List configured providers (default)
`--set PROVIDER`		Set API key for a provider
`--set-service SERVICE`		Set API key for a service (finnhub, fred, etc.)
`--keyring`	`-k`	Store key in system keyring (secure)
`--migrate`		Migrate keys from file to keyring
`--delete-keyring PROVIDER`		Delete provider key from keyring
`--delete-service-keyring SERVICE`		Delete service key from keyring
`--services`		List configured services

Examples:

# List configured API keys
victor keys

# Set Anthropic API key in system keyring (recommended)
victor keys --set anthropic --keyring

# Create template file for manual editing
victor keys --setup

# Migrate all keys from file to secure keyring
victor keys --migrate

# List configured external services
victor keys --services

Codebase Tools¶

`victor index`¶

Manage codebase index for semantic search.

victor index COMMAND [OPTIONS]

`victor index build`¶

Build or rebuild the codebase index.

victor index build [OPTIONS]

Option	Short	Description
`--path`	`-p`	Directory to index (default: current)
`--force`	`-f`	Force full rebuild
`--verbose`	`-v`	Show detailed output

`victor index status`¶

Show index status and statistics.

`victor index clear`¶

Clear the codebase index.

`victor tools`¶

List available tools and their capabilities.

victor tools list [OPTIONS]

Option	Short	Description
`--category`	`-c`	Filter by category
`--cost-tier`		Filter by cost tier (free, low, medium, high)
`--verbose`	`-v`	Show detailed descriptions

Workflow Management¶

`victor workflow`¶

Manage and execute workflows.

victor workflow COMMAND [OPTIONS]

`victor workflow validate`¶

Validate a workflow YAML file.

victor workflow validate PATH

`victor workflow list`¶

List available workflows.

`victor workflow run`¶

Execute a workflow.

victor workflow run WORKFLOW_NAME [OPTIONS]

`victor scheduler`¶

Manage the workflow scheduler daemon.

victor scheduler COMMAND [OPTIONS]

`victor scheduler start`¶

Start the scheduler daemon.

victor scheduler start [OPTIONS]

Option	Short	Description
`--daemonize`	`-d`	Run as background daemon
`--pid-file`		PID file path

`victor scheduler stop`¶

Stop the scheduler daemon.

`victor scheduler status`¶

Show scheduler status.

Vertical Management¶

`victor vertical`¶

Manage vertical packages (domain-specific extensions).

victor vertical COMMAND [OPTIONS]

`victor vertical list`¶

List available verticals.

victor vertical list [OPTIONS]

Option	Short	Description
`--source`	`-s`	Filter: all, installed, builtin, available
`--category`	`-c`	Filter by category
`--tags`	`-t`	Filter by tags (comma-separated)
`--verbose`	`-v`	Show detailed information

`victor vertical install`¶

Install a vertical package.

victor vertical install PACKAGE [OPTIONS]

Option	Short	Description
`--no-validate`		Skip validation checks
`--dry-run`	`-n`	Show what would be installed
`--verbose`	`-v`	Show detailed output

Examples:

victor vertical install victor-security
victor vertical install "git+https://github.com/user/victor-security.git"
victor vertical install ./path/to/package

`victor vertical uninstall`¶

Uninstall a vertical package.

victor vertical uninstall NAME [OPTIONS]

`victor vertical info`¶

Show detailed information about a vertical.

victor vertical info NAME

`victor vertical search`¶

Search for vertical packages.

victor vertical search QUERY

`victor vertical create`¶

Generate a new vertical structure from templates.

The default scaffold now starts with an contract-first definition layer in
assistant.py. service_provider.py remains optional for runtime-only
integration code.

victor vertical create NAME [OPTIONS]

Option	Short	Description
`--description`	`-d`	Description of the vertical's purpose
`--service-provider`	`-s`	Include service_provider.py for DI registration
`--force`	`-f`	Overwrite existing files
`--dry-run`	`-n`	Show what would be created

Session Management¶

`victor sessions`¶

Manage conversation sessions.

victor sessions COMMAND [OPTIONS]

`victor sessions list`¶

List saved sessions.

`victor sessions show`¶

Show session details and conversation history.

victor sessions show SESSION_ID

`victor sessions delete`¶

Delete a session.

victor sessions delete SESSION_ID [--force]

`victor sessions export`¶

Export session to file.

victor sessions export SESSION_ID [--format json|markdown]

Benchmarking¶

`victor benchmark`¶

Run benchmarks against standard datasets.

victor benchmark run BENCHMARK_NAME [OPTIONS]

Option	Short	Description
`--max-tasks`		Maximum tasks to run
`--profile`		Profile to use
`--output`	`-o`	Output directory for results

Available benchmarks: swe-bench, humaneval

Examples:

victor benchmark run swe-bench --max-tasks 10 --profile deepseek
victor benchmark run humaneval --max-tasks 5 --profile default

RAG (Retrieval-Augmented Generation)¶

`victor rag`¶

RAG operations for document ingestion and search.

victor rag COMMAND [OPTIONS]

Option	Short	Description
`--log-level`		Set logging level (DEBUG, INFO, WARN, ERROR)

`victor rag ingest`¶

Ingest documents into the RAG system.

`victor rag search`¶

Search ingested documents.

`victor rag status`¶

Show RAG system status.

MCP (Model Context Protocol)¶

`victor mcp`¶

Manage MCP server connections.

victor mcp COMMAND [OPTIONS]

Option	Short	Description
`--log-level`		Set logging level

`victor mcp list`¶

List configured MCP servers.

`victor mcp add`¶

Add an MCP server configuration.

`victor mcp remove`¶

Remove an MCP server configuration.

`victor mcp test`¶

Test MCP server connectivity.

Utility Commands¶

`victor config`¶

View and manage configuration.

victor config COMMAND

`victor config show`¶

Show current configuration.

`victor config path`¶

Show configuration file paths.

`victor docs`¶

Open documentation.

victor docs [--local]

`victor examples`¶

Show usage examples.

victor examples [TOPIC]

`victor capabilities`¶

Show system capabilities and installed features.

victor capabilities

`victor embeddings`¶

Manage embedding models and caches.

victor embeddings COMMAND [OPTIONS]

`victor embeddings status`¶

Show embedding system status.

`victor embeddings clear`¶

Clear embedding cache.

`victor security`¶

Security scanning and auditing.

victor security COMMAND [OPTIONS]

`victor security scan`¶

Run security scan on codebase.

`victor security audit`¶

Generate security audit report.

`victor dashboard`¶

Launch the observability dashboard.

victor dashboard [OPTIONS]

Option	Short	Description
`--port`	`-p`	Dashboard port (default: 8501)
`--host`		Dashboard host

Exit Codes¶

Code	Meaning
0	Success
1	General error
2	Invalid arguments
130	Interrupted (Ctrl+C)

Environment Variable Overrides¶

CLI options can be overridden via environment variables. See Environment Variables Reference for the complete list.

Common overrides:

Variable	CLI Equivalent
`VICTOR_PROFILE`	`--profile`
`VICTOR_PROVIDER`	`--provider`
`VICTOR_MODEL`	`--model`
`VICTOR_HEADLESS_MODE`	`--headless`
`VICTOR_DRY_RUN_MODE`	`--dry-run`

CLI Command Reference¶

Global Options¶

Default Behavior¶

Core Commands¶

victor chat¶

victor init¶

victor serve¶

Provider & Model Management¶

victor providers¶

victor models¶

victor test-provider¶

Profile Management¶

victor profiles¶

victor profiles list¶

victor profiles create¶

victor profiles edit¶

victor profiles delete¶

victor profiles show¶

victor profiles set-default¶

API Key Management¶

victor keys¶

Codebase Tools¶

victor index¶

victor index build¶

victor index status¶

victor index clear¶

victor tools¶

Workflow Management¶

victor workflow¶

victor workflow validate¶

victor workflow list¶

victor workflow run¶

victor scheduler¶

victor scheduler start¶

victor scheduler stop¶

victor scheduler status¶

Vertical Management¶

victor vertical¶

victor vertical list¶

victor vertical install¶

victor vertical uninstall¶

victor vertical info¶

victor vertical search¶

victor vertical create¶

Session Management¶

victor sessions¶

victor sessions list¶

victor sessions show¶

victor sessions delete¶

victor sessions export¶

Benchmarking¶

victor benchmark¶

RAG (Retrieval-Augmented Generation)¶

victor rag¶

victor rag ingest¶

victor rag search¶

victor rag status¶

MCP (Model Context Protocol)¶

victor mcp¶

victor mcp list¶

victor mcp add¶

victor mcp remove¶

victor mcp test¶

Utility Commands¶

victor config¶

victor config show¶

victor config path¶

victor docs¶

victor examples¶

victor capabilities¶

victor embeddings¶

victor embeddings status¶

victor embeddings clear¶

victor security¶

victor security scan¶

victor security audit¶

victor dashboard¶

Exit Codes¶

Environment Variable Overrides¶

`victor chat`¶

`victor init`¶

`victor serve`¶

`victor providers`¶

`victor models`¶

`victor test-provider`¶

`victor profiles`¶

`victor profiles list`¶

`victor profiles create`¶

`victor profiles edit`¶

`victor profiles delete`¶

`victor profiles show`¶

`victor profiles set-default`¶

`victor keys`¶

`victor index`¶

`victor index build`¶

`victor index status`¶

`victor index clear`¶

`victor tools`¶

`victor workflow`¶

`victor workflow validate`¶

`victor workflow list`¶

`victor workflow run`¶

`victor scheduler`¶

`victor scheduler start`¶

`victor scheduler stop`¶

`victor scheduler status`¶

`victor vertical`¶

`victor vertical list`¶

`victor vertical install`¶

`victor vertical uninstall`¶

`victor vertical info`¶

`victor vertical search`¶

`victor vertical create`¶

`victor sessions`¶

`victor sessions list`¶

`victor sessions show`¶

`victor sessions delete`¶

`victor sessions export`¶

`victor benchmark`¶

`victor rag`¶

`victor rag ingest`¶

`victor rag search`¶

`victor rag status`¶

`victor mcp`¶

`victor mcp list`¶

`victor mcp add`¶

`victor mcp remove`¶

`victor mcp test`¶

`victor config`¶

`victor config show`¶

`victor config path`¶

`victor docs`¶

`victor examples`¶

`victor capabilities`¶

`victor embeddings`¶

`victor embeddings status`¶

`victor embeddings clear`¶

`victor security`¶

`victor security scan`¶

`victor security audit`¶

`victor dashboard`¶