RAG Commands

rcli rag ingest <dir>    # Index documents from a directory
rcli rag query <text>    # Query indexed documents
rcli rag status          # Show index info

rcli rag ingest ~/Documents/notes

# Output:
  RAG Ingest
  Indexing documents from: /Users/you/Documents/notes

  Processing 47 files...
  ✓ Indexed 523 chunks
  ✓ Built vector index (HNSW)
  ✓ Built BM25 index

  Indexing complete!

  Query your docs:
    rcli rag query "your question here"
    rcli ask --rag ~/Library/RCLI/index "your question"

~/Library/RCLI/index/
  ├── chunks.json          # Chunk metadata + text
  ├── embeddings.bin       # Float32 vectors
  ├── usearch.index        # HNSW vector index
  └── bm25.json            # BM25 term frequencies

rcli rag ingest ~/Documents/notes  # First run
rcli rag ingest ~/Documents/notes  # Overwrites previous index

mkdir -p ~/Documents/all-docs
cp -r ~/Documents/notes ~/Documents/all-docs/
cp -r ~/Documents/research ~/Documents/all-docs/
rcli rag ingest ~/Documents/all-docs

rcli rag query "What were the key decisions from the meeting?"

# Output:
The key decisions were:
1. Launch date moved to Q3
2. Budget increased by 20%
3. Hired 2 additional engineers

rcli --rag ~/Library/RCLI/index

# Now all queries use RAG:
> what were the key decisions?
> summarize the project plan

rcli listen --rag ~/Library/RCLI/index

# Speak: "what were the key decisions?"
# RCLI retrieves context and responds

rcli ask --rag ~/Library/RCLI/index "summarize the project plan"

rcli rag status

# Output:
  RAG Index: /Users/you/Library/RCLI/index
  Status: indexed

  No RAG index found.
  Run: rcli rag ingest <directory>

rcli setup  # Includes Arctic Embed S

# Or download manually:
cd ~/Library/RCLI/models
curl -LO https://huggingface.co/snowflake/snowflake-arctic-embed-s-v2.0/resolve/main/arctic-embed-s.gguf

# Index research papers
rcli rag ingest ~/Documents/papers

# Query via voice
rcli listen --rag ~/Library/RCLI/index

# Ask: "what did the paper say about transformers?"

# Index meeting notes
rcli rag ingest ~/Documents/meetings

# Query in interactive mode
rcli --rag ~/Library/RCLI/index

> what were the action items from yesterday's meeting?
> who was assigned to the backend task?

# Index project docs
rcli rag ingest ~/projects/myapp/docs

# Query from command line
rcli ask --rag ~/Library/RCLI/index "how do I configure authentication?"

# Finder drag → Terminal receives path
/Users/you/Documents/project.pdf

# Type: rag ingest /Users/you/Documents/project.pdf
# Or press R (RAG panel), select "Ingest documents", paste path

rcli bench --suite rag --rag ~/Library/RCLI/index

# Output:
--- RAG Benchmark ---
  Embedding: 7.8ms
  Vector search: 2.1ms
  BM25 search: 0.9ms
  RRF fusion: 0.4ms
  Total retrieval: 3.8ms

# Ingest to custom location
rcli rag ingest ~/Documents/notes
# Index saved to ~/Library/RCLI/index (default)

# Query from custom location
rcli rag query "question" --rag /path/to/custom/index

static constexpr int CHUNK_SIZE = 512;   // Default: 512 tokens
static constexpr int CHUNK_OVERLAP = 50; // Default: 50 tokens

static constexpr int TOP_K = 5;  // Default: 5 chunks

Error: Embedding model not found
Run: rcli setup

✗ No supported files found in /path/to/dir

score = Σ (1 / (k + rank_i))
k = 60

#include "api/rcli_api.h"

RCLIHandle engine = rcli_create(NULL);
rcli_init(engine, "/path/to/models", 99);

// Ingest
rcli_rag_ingest(engine, "/path/to/docs");

// Query
const char* response = rcli_rag_query(engine, "your question");
printf("%s\n", response);

// Cleanup
rcli_destroy(engine);