haiku.rag/docs/cli.md

Command Line Interface

The haiku-rag CLI provides complete document management functionality.

Shell Autocompletion

Enable shell autocompletion for faster, error‑free usage.

• Temporary (current shell only):

  eval "$(haiku-rag --show-completion)"
  

• Permanent installation:

  haiku-rag --install-completion
  

What’s completed:

• get and delete/rm: Document IDs from the selected database (respects --db).
• add-src: Local filesystem paths (URLs can still be typed manually).

Document Management

List Documents

haiku-rag list

Add Documents

From text:

haiku-rag add "Your document content here"

From file or URL:

haiku-rag add-src /path/to/document.pdf
haiku-rag add-src https://example.com/article.html

Get Document

haiku-rag get <TAB>
# or
haiku-rag get 3f4a...   # document ID (autocomplete supported)

Delete Document

haiku-rag delete <TAB>
haiku-rag rm <TAB>       # alias

Rebuild Database

Rebuild the database by deleting all chunks & embeddings and re-indexing all documents:

haiku-rag rebuild

Use this when you want to change things like the embedding model or chunk size for example.

Migration

Migrate from SQLite to LanceDB

Migrate an existing SQLite database to LanceDB:

haiku-rag migrate /path/to/old_database.sqlite

This will:

• Read all documents, chunks, embeddings, and settings from the SQLite database
• Create a new LanceDB database with the same data in the same directory
• Optimize the new database for best performance

The original SQLite database remains unchanged, so you can safely migrate without risk of data loss.

Search

Basic search:

haiku-rag search "machine learning"

With options:

haiku-rag search "python programming" --limit 10

Question Answering

Ask questions about your documents:

haiku-rag ask "Who is the author of haiku.rag?"

Ask questions with citations showing source documents:

haiku-rag ask "Who is the author of haiku.rag?" --cite

The QA agent will search your documents for relevant information and provide a comprehensive answer. With --cite, responses include citations showing which documents were used.

Configuration

View current configuration settings:

haiku-rag settings

Server

Start the MCP server:

# HTTP transport (default)
haiku-rag serve

# stdio transport
haiku-rag serve --stdio

# SSE transport
haiku-rag serve --sse

Options

All commands support:

• --db - Specify custom database path
• -h - Show help for specific command

Example:

haiku-rag list --db /path/to/custom.db
haiku-rag add -h