CLI Reference

Complete reference for all Lore CLI commands.

Setup & Auth

Command	Description
`lore setup`	Guided wizard — configure API keys, sign in, create data repo
`lore setup --openai-key <key> --anthropic-key <key> --email <email>`	Non-interactive setup (sends OTP, exits)
`lore setup ... --code <code>`	Complete non-interactive setup with OTP code
`lore auth login`	Sign in with email OTP
`lore auth login -e user@example.com`	Sign in with specified email
`lore auth login -e user@example.com --send-only`	Send OTP and exit
`lore auth login -e user@example.com --code <code>`	Verify OTP non-interactively
`lore auth logout`	Clear session
`lore auth whoami`	Show current authentication status

Search & Research

Command	Description
`lore search <query>`	Hybrid search (semantic + keyword)
`lore search <query> --mode semantic`	Vector similarity only
`lore search <query> --mode keyword`	Full-text search only
`lore search <query> --project <name>`	Filter to project
`lore research <query>`	AI-powered deep research across sources
`lore browse`	Interactive TUI browser

Ingest

Command	Description
`lore ingest "content"`	Ingest inline content
`lore ingest --file ./notes.md`	Ingest from a file
`echo "..." \| lore ingest`	Ingest from stdin/pipe
`lore ingest "content" -p myproject -t "My Title"`	With project and title
`lore ingest --file doc.md --type meeting --url https://...`	With metadata

Sync & Sources

Command	Description
`lore sync`	Sync all configured sources
`lore sync --dry-run`	Preview what would sync
`lore sync add`	Add a source directory (interactive)
`lore sync add --name "Notes" --path ~/notes --project notes`	Add non-interactively (syncs all files)
`lore sync add --name "Docs" --path ~/docs --glob "*/.md" --project docs`	Add with specific file type filter
`lore sync list`	List configured source directories
`lore sync start`	Start background sync daemon
`lore sync stop`	Stop background sync daemon
`lore sync status`	Show daemon status

Supported file formats: Markdown, JSON, JSONL, plain text, CSV, HTML, XML, PDF, and images (JPEG, PNG, GIF, WebP). The default glob is **/* (all files). Use --glob to restrict to specific types.

Documents

Command	Description
`lore docs list`	List all indexed documents
`lore docs get <id>`	View a document by ID

Projects

Command	Description
`lore projects`	List all projects with source counts
`lore projects archive <name>`	Archive a project

MCP Server

Command	Description
`lore mcp`	Start the MCP server (for AI tool integration)

Skills

Command	Description
`lore skills list`	List available agent skills
`lore skills install <name>`	Install a skill
`lore skills show <name>`	Show skill details

Updates

Command	Description
`lore update`	Check for and install the latest version, restart daemon
`lore update --check`	Check for updates without installing

Environment Variables

These can be set via environment or via lore setup (stored in ~/.config/lore/config.json):

Variable	Description
`OPENAI_API_KEY`	Required for embeddings
`ANTHROPIC_API_KEY`	Required for research agent and sync
`SUPABASE_URL`	Supabase project URL (has default)
`SUPABASE_PUBLISHABLE_KEY`	Supabase publishable key (has default)
`SUPABASE_SERVICE_KEY`	Service key — bypasses RLS, env-only
`LORE_DATA_DIR`	Data directory path (default: `~/.lore`)
`LORE_AUTO_GIT_PULL`	Auto git pull every 5 min (default: true)
`LORE_AUTO_INDEX`	Auto-index new sources (default: true)