Practical overview
When it fits
Use Codedb when an MCP-compatible coding agent needs structured repository context to investigate unfamiliar code, locate definitions and callers, or follow a path between symbols. The connected client remains responsible for editing.
Who it is for
- Developers using MCP-compatible AI coding agents to navigate or investigate a repository.
- Teams or individual developers who want agent workflows to retrieve definitions, callers, dependencies, and source context.
Documented uses
- Map repository files and inspect symbol outlines.
- Find symbol definitions and call sites, or trace relationships between symbols.
- Search source and retrieve focused context for an agent’s coding task.
- Use CLI commands to inspect trees, outlines, symbols, search results, or recently modified files.
Requirements & limits
The project describes installation options for macOS, Linux, and Windows. It is open source under the BSD-3-Clause license. The macOS and Linux shell installer can auto-register Codedb with supported clients; other setups may require manual MCP configuration.
- Codedb is a context and navigation tool, not an editor; code changes are made through the coding client’s native tools.
- Structural search runs locally, while default hybrid retrieval also uses hosted embeddings; the README names
semantic=localfor local-only retrieval. - The MCP server communicates over JSON-RPC 2.0 on standard input and output; an HTTP server mode is also documented.
- The README lists a native Windows PowerShell installer and notes that the npm launcher does not yet work on Windows; it directs Windows users to PowerShell meanwhile.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Codedb and start its MCP server on macOS or Linux
Install the binary and register Codedb as an MCP server for a supported coding client.
Before you start
- macOS or Linux
- A supported coding client present for automatic registration
Steps
Run the shell installer: the command below.
curl -fsSL https://codedb.codegraff.com/install.sh | bashOpen a project in the connected coding client to make Codedb’s tools available to the agent.
Expected outcome
Codedb is installed and registered as an MCP server; the agent can access its repository-context tools when a project is open.
Guide limitations
- The installer registers only clients it detects; other clients may need manual MCP configuration.
- This guide covers setup and tool availability, not a particular code investigation or edit.
Compare options for AI coding assistance
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Codedb | Map repository files and inspect symbol outlines. | CLI, Self-hosted, Server | The project describes installation options for macOS, Linux, and Windows. It is open source under the BSD-3-Clause license. The macOS and Linux shell installer can auto-register Codedb with supported clients; other setups may require manual MCP configuration. |
| Overture | Inspect a coding agent’s planned steps and branches before code is written. | Self-hosted, Server, Web | Open-source software under the MIT license. The documented setup runs the MCP server locally and opens its web interface at `http://localhost:3031` by default. |
| Wigolo | Search the web and fetch pages for an agent’s research task. | CLI, Self-hosted, Server | The quickstart lists macOS, Linux and Windows, and requires Node.js 20 or later with about 1.5 GB of free disk space. The repository labels the project public beta. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- justrach/codedb · Official homepage title · retained in its source language