Search & Chat
Search the knowledge base and chat with RAG-powered answers grounded in your indexed content.
search
Perform a hybrid search over the knowledge base and display matching chunks.
| Argument / Option | Type | Required | Default | Description |
|---|---|---|---|---|
<query> |
string | Yes | — | The search query |
--top, -t |
integer | No | 5 | Maximum number of results (1–20) |
--scope, -s |
string | No | DM view | Visibility scope: all or dm-only |
--source, -f |
string | No | All | Filter by source (filename or #N doc ID). Repeatable. |
--category, -c |
string | No | All | Filter by category. Repeatable. |
How search works
Each query runs three parallel searches that are merged using Reciprocal Rank Fusion:
- Vector search — Semantic similarity using embeddings
- Keyword search — Full-text search using PostgreSQL tsvector
- Trigram search — Fuzzy character-level matching for compound words and typos
See How Search Works for details on the retrieval pipeline.
Examples
# Basic search
jime search "dragon abilities"
# More results
jime search "combat rules" --top 10
# Filter by category
jime search "spells" --category rules
# Filter by source
jime search "encounters" --source "rulebook.pdf"
# Combine filters
jime search "treasure" --category sessions --scope all
chat
Ask questions with retrieval-augmented answers grounded in the indexed corpus. Supports single-shot mode, interactive multi-turn chat, and resuming past conversations.
| Argument / Option | Type | Required | Default | Description |
|---|---|---|---|---|
[question] |
string | No | — | Question to ask. Omit for interactive mode. |
--continue |
GUID | No | — | Resume a previous conversation by ID |
--list |
flag | No | — | List recent conversations |
--scope, -s |
string | No | DM view | Visibility scope: all or dm-only |
--source, -f |
string | No | All | Filter by source. Repeatable. |
--category, -c |
string | No | All | Filter by category. Repeatable. |
Modes
Interactive mode
Start a multi-turn conversation. Type your questions and get answers with context from previous turns. Type /quit or /exit to end.
Single-shot mode
Ask a single question and get an answer. The conversation ID is displayed so you can resume later.
Resume a conversation
Continue a previous conversation with full message history:
List conversations
See recent conversations with their IDs and titles:
Response format
Each answer includes:
- The generated answer with source citations (e.g., "(Source 1)")
- A list of sources with file names, page ranges, section headings, and relevance scores
- A conversation ID for resuming later