CLI

vectora [GLOBAL_OPTIONS] COMMAND [COMMAND_OPTIONS]

--version, -v   # Show version
--help, -h      # Show help
--config PATH   # Custom path to vectora.yaml
--namespace NS  # Override default namespace (default: local)
--debug         # Enable debug mode (verbose logging)
--quiet, -q     # Suppress output (except errors)
--json          # JSON output for automation

vectora --version
vectora --debug index
vectora --namespace staging init
vectora --config ./custom.yaml search "query"

vectora init [OPTIONS]

OPTIONS:
  --name NAME # Project name (default: directory name)
  --type TYPE # Type: codebase|docs|hybrid (default: codebase)
  --namespace NS # Customized namespace (default: org-project-env)
  --trust-folder PATH # Trust folder (default: .)
  --providers YAML # Provider config (see config docs)

vectora init --name "My App" --type codebase
# Creates vectora.config.yaml + .vectora/

vectora init --namespace kaffyn-backend-prod --type codebase
# Creates with specific namespace

vectora index [OPTIONS]

OPTIONS:
  --force               # Reindex even if no changes are detected
  --incremental         # New/modified files only (default: true)
  --exclude PATTERN     # Exclude globs (e.g., bin/**, .git/**)
  --include PATTERN     # Include only specific globs (e.g., pkg/**, cmd/**)
  --dry-run             # Simulate indexing without persisting data
  --watch               # Watch for filesystem changes (dev mode)

# Incremental indexing (default)
vectora index

# Reindex everything
vectora index --force

# Go files only
vectora index --include "**/*.go"

# Development mode (watch)
vectora index --watch

# Verify what would be indexed
vectora index --dry-run

vectora search QUERY [OPTIONS]

OPTIONS:
  --strategy STRATEGY # semantic|structural|hybrid (default: semantic)
  --top-k NUM # Number of results (default: 10)
  --format FORMAT # text|json|markdown (default: text)
  --include-snippets # Include code snippet
  --compare-baseline # Compare with previous version

# Simple search
vectora search "How to do login?"

# Structural search for code relationships
vectora search "Who calls getUserById?" --strategy structural

# JSON output
vectora search "validation" --format json

# Search with code snippets
vectora search "middleware" --include-snippets

vectora analyze QUERY [OPTIONS]

OPTIONS:
  --model MODEL # LLM to use (default: gemini-3-flash)
  --context NUM # How many chunks to use (default: 10)
  --output FILE # Save to file (e.g., report.md)
  --compare-baseline # Compare with previous analysis

# Simple analysis
vectora analyze "How does authentication work?"

# Deep analysis
vectora analyze "Review this code for security" --model gemini-pro --context 20

# Save to file
vectora analyze "Write API documentation" --output docs/api.md

vectora config [SUBCOMMAND]

SUBCOMMANDS:
  get KEY # Get value
  set KEY VALUE # Set value
  list # List all
  validate # Validate current config
  reset # Reset to default
  show-schema # Show YAML schema

# View current configuration
vectora config list

# View specific key
vectora config get project.namespace

# Set key
vectora config set context_engine.strategy semantic

# Validate config
vectora config validate

# View available schema
vectora config show-schema

vectora namespace [SUBCOMMAND]

SUBCOMMANDS:
  create --name NS # Create new namespace
  delete --name NS # Delete namespace (PERMANENT)
  list # List all namespaces
  info --name NS # Details of a namespace
  reset --name NS # Clear chunks of a namespace

# List namespaces
vectora namespace list

# Create new
vectora namespace create --name kaffyn-new-project

# View details
vectora namespace info --name kaffyn-vectora-prod

# Clear namespace
vectora namespace reset --name kaffyn-old-project

vectora mcp [OPTIONS]

OPTIONS:
  --port PORT # Port (default: 9090)
  --host HOST # Host (default: localhost)
  --namespace NS # Default namespace
  --no-auth # Disable authentication (dev only)

# Start server
vectora mcp

# With custom port
vectora mcp --port 9091

# Public server
vectora mcp --host 0.0.0.0 --port 9090

vectora server [OPTIONS]

OPTIONS:
  --port PORT # Port (default: 3000)
  --host HOST # Host (default: localhost)
  --ui # Enable web dashboard
  --webhooks # Enable webhooks support
  --cert FILE # SSL/TLS certificate
  --key FILE # SSL/TLS key

# Basic server
vectora server

# With web UI
vectora server --ui

# HTTPS with certificate
vectora server --cert cert.pem --key key.pem

vectora auth [COMMAND]

COMMANDS:
  login     # Start browser-based SSO flow
  logout    # End local session
  status    # Show logged-in user and token validity
  token     # Manage personal access tokens (PAT)

# Interactive Login (opens browser for SSO, Systray UI syncs automatically)
vectora auth login

# Check account status
vectora auth status

vectora logs [OPTIONS]

OPTIONS:
  --level LEVEL # debug|info|warn|error (default: info)
  --service SERVICE # Filter by service
  --since DURATION # Last N hours (e.g., 24h)
  --follow, -f # Stream logs in real-time
  --format FORMAT # text|json (default: text)

# View recent logs
vectora logs --since 1h

# Debug logs in real-time
vectora logs --level debug --follow

# Search logs only
vectora logs --service search --since 24h

# JSON for parsing
vectora logs --format json | jq '.[]'

vectora metrics [OPTIONS]

OPTIONS:
  --period PERIOD # 24h|7d|30d (default: 24h)
  --export FORMAT # csv|json|prometheus (default: text)
  --output FILE # Save to file

# Metrics of the last day
vectora metrics --period 24h

# Export as CSV
vectora metrics --period 7d --export csv --output metrics.csv

# Prometheus format
vectora metrics --export prometheus

vectora audit [OPTIONS]

OPTIONS:
  --action ACTION # Filter by action (search|index|delete)
  --user USER # Filter by user
  --since DURATION # Since when (e.g., 7d)
  --limit NUM # Line limit (default: 100)

# Full audit
vectora audit

# Searches of the last 7 days
vectora audit --action search --since 7d

# Deletions by user
vectora audit --action delete --user "your-email@company.com"

vectora health [OPTIONS]

OPTIONS:
  --detailed # Show details of each component
  --fix # Attempt to fix problems

# Fast health
vectora health

# With details
vectora health --detailed

# Attempt to fix
vectora health --fix

0 # Success
1 # Generic error
2 # Configuration error
3 # API error
4 # Authentication failed
5 # Namespace not found

VECTORA_NAMESPACE=staging vectora search "..."
VECTORA_LOG_LEVEL=debug vectora index
VECTORA_CONFIG=./custom.yaml vectora init
VECTORA_TRUST_FOLDER=./src vectora index