BlogGuides

Index Your Codebase and Search It by Voice

·5 min read

Vox's knowledge base isn't just for PDFs and documents — it can index your entire codebase. Every function, every config file, every README becomes searchable by voice. Here's how to set it up for development workflows.

Add your project folder

Go to the Knowledge tab and add your project directory:

Vox — Indexing Codebase
Scanning ~/Projects/my-app — found 1,247 filesDone
Filtering: .js, .ts, .py, .json, .md, .yaml...Done
Chunking: 1,400 chars per chunk, 200-char overlapDone
Indexing with 4 parallel workersDone
Indexed 1,247 files — codebase searchableDone

Search your code by voice

Computer, where is the authentication middleware defined?

Search Results
Found in 3 files:
src/middleware/auth.js (lines 12-45)
exports function authMiddleware that validates JWT tokens...
src/routes/index.js (line 8)
imports and applies authMiddleware to /api routes...
tests/auth.test.js (lines 5-89)
Test suite for authentication middleware...

Ask questions about your code

Don't just search — have a conversation about your codebase:

Computer, how does the payment flow work in this project?

Computer, what environment variables does this app need?

Computer, are there any TODO comments in the codebase?

Computer, explain what the webhook handler does.

Tip

Vox uses the FTS5 index to find relevant code, then uses AI to explain and summarize it. It's like having a senior developer who read every line of your codebase available on voice command.

Supported file types

Code File Types
JavaScript: .js, .jsx, .mjs, .cjs
TypeScript: .ts, .tsx
Python: .py, .pyw
Ruby: .rb, .erb
Go: .go
Rust: .rs
Java: .java
Config: .json, .yaml, .yml, .toml, .env
Web: .html, .css, .svg
Docs: .md, .txt, .rst

Auto-reconcile for active development

Vox re-scans indexed folders every 10 minutes. As you write code, new files and changes are automatically picked up. No manual re-indexing.

Note

All code indexing happens locally. Your source code stays on your machine in a local SQLite database. Nothing is uploaded to any cloud service.


Index once, search forever. Your codebase becomes a conversational knowledge base that you can query by voice while writing code.

Put Vox to work on your computer.

Download Vox for Mac and start with the local setup flow.

Download for Mac

macOS · Apple Silicon & Intel