# Command Line Interface

The `haiku-rag` CLI provides complete document management functionality.

## Document Management

### List Documents

```bash
haiku-rag list
```

### Add Documents

From text:
```bash
haiku-rag add "Your document content here"
```

From file or URL:
```bash
haiku-rag add-src /path/to/document.pdf
haiku-rag add-src https://example.com/article.html
```

### Get Document

```bash
haiku-rag get 1
```

### Delete Document

```bash
haiku-rag delete 1
```

### Rebuild Database

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

```bash
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:

```bash
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:
```bash
haiku-rag search "machine learning"
```

With options:
```bash
haiku-rag search "python programming" --limit 10
```

## Question Answering

Ask questions about your documents:
```bash
haiku-rag ask "Who is the author of haiku.rag?"
```

Ask questions with citations showing source documents:
```bash
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:
```bash
haiku-rag settings
```

## Server

Start the MCP server:
```bash
# 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:
```bash
haiku-rag list --db /path/to/custom.db
haiku-rag add -h
```