@operor/cli

CLI tool for Operor — setup wizard, diagnostics, testing, and knowledge base management.

Install

pnpm add -g @operor/cli

Commands

Setup & Runtime

operor setup    # Interactive setup wizard
operor start    # Start with existing .env config
operor status   # Show configuration status
operor doctor   # Validate config and test connections
operor test     # Run demo test scenarios

Configuration

operor config show          # Show current config
operor config set KEY VALUE # Set a config value
operor config unset KEY     # Remove a config value

Knowledge Base

Requires KB_ENABLED=true in .env (set via operor setup or operor config set).

# Ingest content
operor kb add-url <url>                    # Ingest a web page
operor kb add-file <path>                  # Ingest a document (PDF, TXT, MD, etc.)
operor kb add-faq <question> <answer>      # Add a manual FAQ entry

# Browse & search
operor kb list                             # List all documents
operor kb search <query>                   # Search with relevance scores
operor kb search <query> -n 10             # Search with custom result limit

# Manage
operor kb delete <id>                      # Delete a document by ID
operor kb stats                            # Show KB statistics (docs, chunks, DB size)

Examples

# Add your docs
operor kb add-url https://docs.example.com/faq
operor kb add-file ./product-manual.pdf
operor kb add-faq "What are your hours?" "We're open Mon-Fri 9am-5pm EST."

# Test retrieval
operor kb search "return policy"

# Check stats
operor kb stats

KB Configuration

Set during operor setup or manually via operor config set:

| Variable | Description | Default | |---|---|---| | KB_ENABLED | Enable knowledge base | false | | KB_DB_PATH | SQLite database path | ./knowledge.db | | KB_EMBEDDING_PROVIDER | openai, google, mistral, cohere, or ollama | openai | | KB_EMBEDDING_MODEL | Embedding model name | Provider default | | KB_EMBEDDING_API_KEY | API key for embeddings | — |