CLI Reference

CLI reference

Run rgr in the repository that owns the knowledge base. rgr --help and rgr <command> --help are the option-level source of truth.

Core commands

Command	Purpose
setup [--semantic]	Initialize local state, sources, agent helpers, and optional embeddings
init	Create basic local configuration only
doctor [--fix]	Check setup, index freshness, and safe repairs
preview	Parse, redact, and chunk without writing an index
ingest [--rebuild]	Incrementally index sources or rebuild after retrieval changes
search <query>	Return ranked cited passages
ask <query>	Return cited context without model synthesis
research <query>	Run audit-backed multi-query retrieval
audit [--unsupported]	Compare files with the index and report skipped content
bases	List root and nested monorepo knowledge bases
status	Show the effective configuration and indexed chunk count
security-audit [--strict]	Check privacy and local-state posture

Sources and retrieval

rgr sources add "docs/**/*.md" "!docs/archive/**"
rgr preview --path docs --max-files 5 --max-chunks 3
rgr search "migration" --top-k 5 --context-radius 1
rgr search "migration" --context-path "Guide > Migration" --explain

Search, ask, and research support include and exclude path filters. Use --compact when consumer context is limited. Use --explain to expose reciprocal-rank-fusion contributions, retriever ranks, raw backend scores, and matched terms without changing ranking.

Optional local features

rgr models pull --enable
rgr ocr setup --language eng+fra
rgr chat setup --profile fast
rgr audio ./brief.md --offline --out .ragmir/audio/brief.wav

OCR runs only for blank PDF pages. Chat and offline audio use preloaded local models during normal operation.

Automation

rgr serve-mcp
rgr evaluate --golden .ragmir/golden.json --fail-under 0.8
rgr usage-report --days 30
rgr destroy-index --yes

Add --json to machine-readable commands. Do not parse human-readable output in automation.

Agents and maintenance

Command	Purpose
install-agent	Install native project or user-scoped agent helpers
install-skill	Refresh the canonical Ragmir skill kit
route-prompt	Classify whether a prompt should use retrieval without storing it
limits	Inspect active parser and ingestion limits
usage-report	Summarize metadata-only local access logs
destroy-index --yes	Remove generated index data explicitly

Use install-agent --force only after reviewing a conflicting same-name skill. Project scope and symlink mode are the safe defaults.

Canonical source: docs/cli-reference.md.