Database Inspector

Interactive TUI for browsing your LanceDB database.

Installation

# For haiku.rag-slim
pip install 'haiku.rag-slim[inspector]'

# Already included in haiku.rag
pip install haiku.rag

Usage

haiku-rag inspect
haiku-rag inspect --db /path/to/database.lancedb

Interface

Three panels display your data:

Documents (left) - All documents in the database
Chunks (top right) - Chunks for the selected document
Detail View (bottom right) - Full content and metadata

Keyboard:

Tab - Cycle between panels
↑ / ↓ - Navigate lists
/ - Open search modal
c - Open context expansion modal (when viewing a chunk)
v - Open visual grounding modal (when viewing a chunk)
q - Quit

Mouse: Click to select, scroll to view content

Search

Press / to open the full-screen search modal:

Enter your query and press Enter to search
Left panel: Search results with relevance scores [0.95] content preview
Right panel: Full chunk content and metadata
Use ↑ / ↓ to navigate results - detail view updates in real-time
Press Enter on a result to close search and navigate to that document/chunk
Press Esc to close search without selecting

Search uses hybrid (vector + full-text) search across all chunks. Content is rendered as markdown with syntax highlighting.

Context Expansion

Press c while viewing a chunk to open the context expansion modal:

Shows the expanded context that would be provided to the QA agent
Type-aware expansion: tables, code blocks, and lists expand to their complete structures
Text content expands based on text_context_radius setting
Includes metadata like source document, content type, and relevance score
Press Esc to close the modal

Visual Grounding

Press v while viewing a chunk to open the visual grounding modal:

Shows page images from the source document with the chunk's location highlighted in yellow/orange
Use ← / → arrow keys to navigate between pages (when chunk spans multiple pages)
Press Esc to close the modal

!!! note Visual grounding requires documents with a stored DoclingDocument that includes page images. Text-only documents or documents imported without DoclingDocument won't have visual grounding available.

2.4 KiB Raw Blame History