How to Set Up Your Knowledge Base in Vox

Vox's knowledge base turns your documents into an instantly searchable library. PDFs, Word docs, text files, markdown, code — over 50 file types indexed locally on your machine. Here's how to set it up.

Step 1: Open the Knowledge tab

Click Knowledge in the left sidebar. You'll see an empty state with an option to add folders.

Step 2: Select folders to index

Click “Add Folder” and select one or more directories. Vox will recursively scan all files inside them.

Step 3: Indexing happens automatically

Once you add a folder, Vox begins indexing immediately. It processes 4 files in parallel using a worker pool:

Step 4: Search your knowledge base

Once indexed, you can search everything by voice:

Vox uses SQLite FTS5 full-text search to find relevant passages across all your indexed documents. Results include the source file, the matching passage, and surrounding context.

Auto-reconcile

Vox automatically checks for changes every 10 minutes. New files are indexed, deleted files are removed from the index, and modified files are re-indexed. You don't need to manually refresh.

Tips for power users

• Be specific — “Search for the API authentication spec” works better than “search for documents”
• Use natural language — Vox understands context, not just keywords
• Index your codebase — great for finding function definitions and config files
• Keep folders organized — the cleaner your folder structure, the better the results

Your knowledge base grows more useful over time. The more you add, the more Vox can reference when answering questions and completing tasks.