01Run
Try agent variants.
Graff samples agent strategies and runs them against real repository work.
Free, open source, and improving with every run
Agents that finish the work. A harness that keeps what works.
graff runs real repository tasks, scores every outcome, and reuses the agent strategies that win. Routing across providers cuts cost per task by up to 20x.
Use graff on its own. Add CodeDB for structural repository context. Upgrade to CodeDB Pro for a persistent local toolchain.
EVOLVE · graff · free
The harness runs, scores, and evolves the work loop.
MAP · CodeDB · free
MOVE · CodeDB Pro
curl -fsSL https://github.com/justrach/codegraff/releases/latest/download/install.sh | sh
Sign in with the subscription you already have:
CodexKimiGrok
graff is open source. CodeDB is free. CodeDB Pro is optional.
~20×
lower cost per task, multi-provider routing
~1.8 ms
measured cold start
8
parallel subagents measured
~45×
fewer context tokens per structural read
Graff's core loop
It does not just run agents. It evolves them.
Graff turns completed work into a fitness signal, keeps a diverse archive of strong strategies, and uses that archive to guide future runs.
02Score
Measure the outcome.
Success, cost, speed, and errors become a fitness signal for each variant.
03Select
Keep useful winners.
High-performing variants enter a MAP-Elites archive by task niche and provider class.
04Reuse
Make the next run better.
Future runs sample stronger strategies more often while preserving useful diversity.
Graff owns the evolutionary loop. CodeDB improves what Graff or another coding agent can see. CodeDB Pro accelerates repeated local tool work.
Three products. Clear boundaries.
Start with the evolutionary harness. Add a structural map when repository context gets expensive. Turn on Pro when repeated tool calls become the bottleneck.
EVOLVE
Free · open sourcegraff
Run. Score. Improve.
The evolutionary coding harness that runs real tasks, measures outcomes, and reuses stronger agent strategies over time.
MAP
Free · independentCodeDB
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 upgradeCodeDB Pro
Keep the loop moving.
A persistent local daemon with batched operations, symbol-safe edits, and a higher-leverage toolchain.
graff works on its own. CodeDB works on its own. CodeDB Pro adds a faster local toolchain without taking the free map away.
Choose the tool for the work.
graff runs and improves the coding loop. CodeDB gives Graff or another supported client structural repository context. Pro accelerates repeated local tool work. Switch the example to see the boundary.
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 foundContext returned
47 tokens
8 symbols mapped
The result changes with the tool. The task does not.
CodeDB is free and works without graff.
Code intelligence for any coding agent.
Install CodeDB once and connect it to a supported MCP client. It gives the agent a structural route through the repository before it reads or changes code. Graff can use that map, but CodeDB is a standalone tool.
curl -fsSL https://codedb.codegraff.com/install.sh | bash
Works out of the box with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin.
- Context
- A task-shaped map of likely files, symbols, dependencies, and focused excerpts.
- Symbols
- Definitions and outlines without pouring whole files into the model context.
- Impact
- Callers and dependency edges before the agent edits a shared path.
- 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 --bodyStep 03
Trace the impact.
Callers and dependency lookups show the agent what the change can affect before it edits anything.
codedb callers refreshSessionMeasured on one 2,318-line file
Same task. Less baggage.
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
What CodeDB Pro adds.
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.
more leverage per call
Your repo stays 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. Pro earns its keep.
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.
Engineering organization · 10+ seats
Volume pricing, annual invoicing, and MSA on request.
The short answers.
What is CodeGraff?+
CodeGraff is the project behind graff, the free open-source evolutionary coding harness. Graff runs tasks, scores outcomes, and improves which agent strategies get reused. CodeDB is a separate free code-intelligence tool, and CodeDB Pro is its paid local tooling upgrade.
What makes graff evolutionary?+
Graff runs agent variants, scores completed work across success, cost, speed, and errors, and keeps strong strategies in a MAP-Elites archive. Future runs sample higher-fitness strategies more often while retaining useful diversity.
Can I use CodeDB without graff?+
Yes. CodeDB works independently with supported clients including Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Devin. graff can use it too, but neither product requires the other.
Is CodeDB free?+
Yes. CodeDB is free and open source. CodeDB Pro is the paid operating upgrade: a persistent local daemon, batching, symbol-safe editing, and the higher-leverage tool suite.
Does it send my source code anywhere?+
No. Local CodeDB and Pro tool operations do not send repository paths, queries, file contents, edits, or tool results to a remote MCP host. Gateway inference is a separate product with 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.
Install graff.
The open-source evolutionary harness runs the task and learns from the outcome. Add free CodeDB when your agent needs structural repository context. CodeDB Pro adds the persistent local daemon and write tools.
