CLI Reference
All 16 Lore commands with their options, flags, and usage examples.
Setup & Capture
| Command |
Description |
lore init |
Initialize .lore/ in the current repo, install git post-commit hook |
lore log |
Log an entry interactively or via flags |
lore mine [path] |
Scan a file or directory for lore-worthy comments |
lore watch |
Start the file watcher in the foreground |
lore embed |
Build semantic search index using Ollama |
Review & Edit
| Command |
Description |
lore ui |
Launch the local web dashboard |
lore drafts |
Review pending auto-captured drafts interactively |
lore edit <id> |
Open an entry JSON in your editor |
Query & Export
| Command |
Description |
lore prompt <query> |
Generate a formatted LLM context prompt from project memory |
lore why <file> |
Show all entries relevant to a file or directory |
lore search <query> |
Search entries by keyword (semantic if Ollama is running) |
lore graph [filepath] |
Show dependency graph stats or file details |
lore export |
Generate CLAUDE.md at project root |
Health & Onboarding
| Command |
Description |
lore status |
Entry counts, draft count, stale summary |
lore stale |
Full stale report with semantic pattern analysis |
lore score |
Lore Score (0–100): coverage, freshness, depth |
lore onboard |
Print a re-onboarding brief for the project |
AI Integration
| Command |
Description |
lore serve |
Start the MCP server (stdio) for Claude Code / Cursor |
Command Details
lore log
| Flag |
Description |
--type <type> |
decision, invariant, graveyard, or
gotcha |
--title <title> |
Entry title |
--context <context> |
Context / reasoning |
--alternatives <alts> |
Alternatives considered |
--tradeoffs <tradeoffs> |
Tradeoffs of the choice |
--tags <tags> |
Comma-separated tags |
--files <files> |
Comma-separated file paths for staleness linking |
Without flags, lore log launches an interactive prompt.
lore watch
| Flag |
Description |
-d, --daemon |
Run as a background daemon process |
--stop |
Stop the running background daemon |
lore prompt
| Flag |
Description |
Default |
-t, --threshold <n> |
Relevance threshold (0.0–1.0) |
0.4 |
-l, --limit <n> |
Max entries to include |
10 |
lore ui
| Flag |
Description |
Default |
-p, --port <port> |
Port to run the dashboard on |
3333 |
lore drafts
| Flag |
Description |
--auto |
Auto-accept drafts with confidence ≥ 0.8 |
lore graph
| Flag |
Description |
--build |
Rebuild the full dependency graph from source |
lore onboard
| Flag |
Description |
Default |
--days <n> |
Only show if away for at least N days |
0 |
lore serve
| Flag |
Description |
-q, --quiet |
Suppress startup messages (for piping into MCP client) |