haiku.rag/docs/cli.md

Command Line Interface

The haiku-rag CLI provides complete document management functionality.

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 1

Delete Document

haiku-rag delete 1

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.

Search

Basic search:

haiku-rag search "machine learning"

With options:

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

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