Skip to content
Sign in

Votrio CLI Commands

Complete reference for all votrio commands and options.

init

Initialize votrio in your project. Creates config file, .votrio/ directory, and updates .gitignore.

votrio init

Options

--skip-gitignore

Don't modify .gitignore (default: false)

What It Does

  • Detects your project stack (Node.js, TypeScript, Go, etc)
  • Creates votrio.config.mjs with sensible defaults
  • Creates .votrio/ directory for custom rules and data
  • Adds .votrio/ to .gitignore to avoid committing cache

Example

Output
$ cd my-project
$ votrio init

→ Detecting project stack...
✓ Node.js / TypeScript detected
✓ Created votrio.config.mjs
✓ Added .votrio/ to .gitignore

Ready. Run: votrio run "npm start"
run

Wrap a process and intercept stack traces for AI analysis. Streams explanations as errors occur.

votrio run "npm start"

Options

--no-ai

Disable AI analysis, just pipe output through (default: false)

--model <model>

Specify Anthropic model (default: claude-sonnet-4-20250514)

--verbose

Print debug info from votrio itself

Examples

# Wrap your dev server
votrio run "npm start"

# Works with any process
votrio run "python app.py"
votrio run "go run ."
votrio run "cargo run"

# Use a different AI model for faster analysis
votrio run --model claude-haiku-3.5 "npm test"

# Disable AI (just pipe output through)
votrio run --no-ai "npm start"

# Debug votrio itself
votrio run --verbose "npm start"

Requirements

  • Anthropic API key configured (run votrio auth)
  • votrio.config.mjs present in project root
scan

Scan a directory for security vulnerabilities and code quality issues. Supports multiple output formats and CI integration.

votrio scan [path]

Options

--fix

Auto-apply safe patches where possible

--ci

Exit with code 1 if issues found (for CI pipelines)

--fail-on <severity>

Fail when issues of this severity or higher are found: low | medium | high | critical (default: high)

--format <fmt>

Output format: text | json | markdown | sarif (default: text)

--ignore <patterns...>

Glob patterns to exclude from scan (can specify multiple)

--rules <path>

Path to custom rules JSON (default: .votrio/rules.json)

--watch

Daemon mode: rescan on file changes

--publish

Publish scan summary to Supabase scan_history table

--ai

Enable AI refactoring suggestions via Mistral

--ai-model <model>

Mistral model name (default: mistral-large-latest)

Examples

# Scan current directory
votrio scan

# Scan specific path
votrio scan ./src

# Scan and auto-fix safe issues
votrio scan --fix

# CI/CD integration
votrio scan --ci --fail-on high

# Export as JSON for tooling
votrio scan --format json > scan-results.json

# Ignore certain paths
votrio scan --ignore "**/*.test.js" --ignore "**/node_modules/**"

# Watch mode for development
votrio scan --watch

# Get AI suggestions
votrio scan --ai --ai-model mistral-large-latest

What It Detects

  • Hardcoded secrets and credentials
  • eval() usage and code injection risks
  • dangerouslySetInnerHTML and XSS vulnerabilities
  • Child process execution risks
  • Custom security rules (from .votrio/rules.json)
auth

Configure your Anthropic API key for AI-powered features. Stores credentials securely in your home directory.

votrio auth

Options

--clear

Remove stored API key credentials

Examples

# Set up API key (prompts for input)
votrio auth

# Clear stored credentials
votrio auth --clear

# Alternative: Set via environment variable
export ANTHROPIC_API_KEY="sk-ant-..."
votrio run "npm start"

Getting Your API Key

  1. Visit console.anthropic.com
  2. Sign up or log in to your account
  3. Navigate to API Keys section
  4. Create a new API key
  5. Run votrio auth and paste the key when prompted
Global Options

These options work with any votrio command:

-v, --version

Print votrio version

-h, --help

Show help message

votrio --version
votrio --help
votrio run --help
Getting Help
# General help
votrio --help

# Help for specific command
votrio init --help
votrio run --help
votrio scan --help
votrio auth --help