Main
Index once, query many: use
codedb mcp <repo>so agents can ask for outlines/search/dep graphs without repeated full scans.Keep privacy boundaries: README mentions sensitive file blocking (e.g.,
.env); still review what you index on shared machines.Use HTTP mode for debugging and MCP stdio for production agent use—keep the tool surface consistent.
Prefer structural tools over raw grep: outlines and dependency graphs often answer “where is this used?” faster than text search.
Source-backed notes
- README describes a Zig core with MCP-native support and lists 16 MCP tools for codebase intelligence.
- README install is a one-liner
install.shthat auto-registers the MCP server for multiple AI CLIs. - README shows quick start for MCP (
codedb mcp) and HTTP server (codedb serve).
FAQ
- Do I need to build from source?: No — README provides a one-line installer that downloads release binaries and configures MCP.
- Is it safe for secrets?: README mentions sensitive file blocking, but you should still avoid indexing secret-heavy folders.
- How do agents use it?: Run
codedb mcp <repo>and then call MCP tools for search/outline/graph from your MCP client.