# codedb-mcp-fast-code-intelligence

The codedb-mcp-fast-code-intelligence skill guides setup of a local MCP server that indexes a repository for symbol lookup, reference searches, and dependency analysis. Use it to explore a codebase without dumping whole files into chat.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 116 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/codedb-mcp-fast-code-intelligence/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/codedb-mcp-fast-code-intelligence

## What it does

The server builds a tree-sitter index and keeps its database in the project’s `.codedb-mcp/` directory. It can locate symbol declarations and callers, show a file’s outline, and search indexed text or regex patterns. The `codedb_context` and `codedb_explore` tools return selected code passages instead of entire files.

Building from source requires Rust; the listed setup also calls for Node.js and a Git repository to index. Create `.codedb-mcp/codedb-mcp.toml` to set the project root and file patterns, then run the initial index and configure the MCP connection. The tools cannot work until the server binary is built and connected to the agent.

You can refresh the index incrementally or rebuild it, and `codedb_status` reports its condition. Vector search relies on a model configured for the project. The described setup stores server data in the repository, rather than sending it to a cloud service.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codedb-mcp-fast-code-intelligence -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/codedb-mcp-fast-code-intelligence/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/codedb-mcp-fast-code-intelligence/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codedb-mcp-fast-code-intelligence -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/codedb-mcp-fast-code-intelligence/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codedb-mcp-fast-code-intelligence -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/codedb-mcp-fast-code-intelligence/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/codedb-mcp-fast-code-intelligence
```

2. **Manually: put the files in place**
- File: `.github/skills/codedb-mcp-fast-code-intelligence/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codedb-mcp-fast-code-intelligence -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/codedb-mcp-fast-code-intelligence
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/codedb-mcp-fast-code-intelligence/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codedb-mcp-fast-code-intelligence -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/codedb-mcp-fast-code-intelligence/SKILL.md

## When to use it
- locate a class or function declaration across a repository
- trace callers before changing a symbol
- search indexed files with text or a regex
- inspect dependencies between code modules
- view the symbol outline of a file

## Example prompts
- Find the definition of `PoolManager` and show where the code calls it.
- Map the dependencies around `AuthController` and identify the related files.
- Search under `src` for occurrences of `NetworkListenerManager`.

## Similar
- [smart-explore](https://affpapa.org/en/nevibecode/skills/smart-explore.md) — skill · 7800 installs
- [grepai-languages](https://affpapa.org/en/nevibecode/skills/grepai-languages.md) — skill · 742 installs
- [codegraph](https://affpapa.org/en/nevibecode/skills/codegraph.md) — skill · 891 installs
- [jCodemunch MCP](https://affpapa.org/en/nevibecode/mcp/jcodemunch-mcp.md) — MCP server · ★ 2857 repo stars
- [Octocode](https://affpapa.org/en/nevibecode/mcp/octocode.md) — MCP server · ★ 529 repo stars
- [Sense](https://affpapa.org/en/nevibecode/mcp/sense.md) — MCP server · ★ 48 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
