CodeDB · Free local code intelligence

Find the code for your coding agent.

Give your agent a map of definitions, callers and dependencies. CodeDB runs locally and connects over MCP, so you can keep the coding client you already use.

View CodeDB on GitHub ↗

curl -fsSL https://codedb.codegraff.com/install.sh | bash

Works out of the box with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin.

See the CodeDB search guide or read how local code intelligence reduces agent context.

Illustration of CodeDB tracing a precise structural path through a software repository.

Context: Find the files, symbols and source excerpts relevant to your task.
Symbols: Read definitions and file outlines with focused source context.
Impact: See callers and dependencies before changing shared code.
Local: The index and working data stay on the machine.

Step 01

Orient around the task.

CodeDB gives the client likely files, symbols, dependencies, and focused source excerpts.

codedb context "fix session refresh"

Step 02

Read the right symbol.

Outline maps the file first. Symbol reads pull the exact definition instead of pouring the whole file into context.

codedb symbol refreshSession --body

Step 03

Trace the impact.

Callers and dependency lookups show the agent what the change can affect before it edits anything.

codedb callers refreshSession

Choose the tool for the work.

Compare a whole-file read, a CodeDB outline and a Pro edit. Each example shows what the agent asks for and what the tool returns.

See the measured calls ↓

same task · measured example

Structural lookup

$ codedb outline src/auth.ts

→ SessionStore       L18
→ validateToken      L61
→ handleAuth         L94
→ refreshSession     L137
  exact scope found

Context returned

47 tokens

8 symbols mapped

The result changes with the tool. The task does not.

Measured on one 2,318-line file

Read the relevant code. Spend less context.

One real 2,318-line file measured three ways. Results vary by repository and task, so the methodology stays visible.

Understand a 2,300-line file

29× leaner than the raw dump

865 tok

with CodeDB Pro

codedb 6,305 tok25,324 toktoday

Search the whole codebase

codedb’s search engine ships inside Pro

built in

with CodeDB Pro

codedb 2,160 tok5,938 toktoday

Edit one function

Pro only · codedb reads, it doesn’t edit

1.9 KB

with CodeDB Pro

169 KBtoday

codedb-pro 0.2.9 · same 2,318-line file · raw read vs structural read vs exact symbol

Same query

6.4×

faster on a 4.7 GB repo

zigrep5.2ms

ripgrep33.1ms

hyperfine · macOS arm64 · n=10

Run, search, edit. Choose what you need.

Use Graff to run coding tasks, CodeDB to find relevant code, and Pro to batch local reads and edits. Graff and CodeDB can each work independently.

EVOLVE

Free · open source

graff

Run the task.

Connect your model and tools, run repository tasks, and evaluate which strategies complete the work.

MAP

Free · independent

CodeDB

Map the repo.

Local structural code intelligence that works with Graff or another supported coding agent. It maps symbols, outlines, callers, and dependencies.

MOVE

Paid upgrade

CodeDB Pro

Batch the work.

Keep a local daemon ready for repeated searches, reads, diffs and edits. Address changes by symbol name.

Graff and CodeDB are free and open source. CodeDB Pro is an optional paid upgrade.

What CodeDB Pro adds.

Read the docs ↗

Persistent local daemon

The toolchain stays warm instead of paying process startup on every call.

one local process

Batched operations

Read, search, diff, and edit in parallel over one request.

10 reads in 7ms

Symbol-safe edits

Target functions by name, guard the revision, and verify the write on disk.

1.9 KB vs 169 KB

Focused tool suite

Purpose-built local tools for search, reads, patches, diffs, memory, and parallel work.

search · read · edit · verify

CodeDB works on your machine.

CodeDB Pro is a local daemon with zero runtime dependencies on supported binaries. Tool operations do not send code, paths, queries, edits, or results to a remote MCP host.

Supported clients: Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin.

CodeDB stays free. Add Pro when you need it.

graff and CodeDB remain free. Pro is an annual local-tooling license with a 14-day refund, keys by email, and no auto-renew lock-in.

Individual

$99

per year · 1 seat

All tools, every supported editor, one engineer.

Team

$160

per year · 2 seats

$80 per seat. Save $38 versus two solo licenses.

Team Plus

$349

per year · 5 seats

$69.80 per seat. Same-day checkout link by email.

Get Pro for 5 seats

Engineering organization · 10+ seats

Volume pricing, annual invoicing, and MSA on request.

Discuss a team rollout ↗

The short answers.

Can I use CodeDB without Graff?+

Yes. CodeDB connects over MCP to supported clients including Claude Code, Codex, Gemini CLI, Cursor, Windsurf and Devin. You can use it with Graff or your existing coding agent.

Is CodeDB free?+

Yes. CodeDB is free and open source. CodeDB Pro is an optional paid upgrade with a persistent local daemon, batched operations and symbol-safe editing.

Do CodeDB tools upload my code?+

CodeDB and Pro process repository data locally. Their tool operations do not upload code, paths, queries or edits to a remote MCP host. Your coding agent may send context to its model provider; that is a separate data path.

Do I need to change editors?+

No. CodeDB speaks MCP and works with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Devin. Remove it and your agent falls back to its built-in tools.

What platforms are supported?+

The current Pro binaries support macOS arm64 and Linux x86_64 with zero runtime dependencies.