Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@

## Unreleased

## 0.2.5857 - 2026-09-26

- Auto-register codedb in additional detected MCP clients: oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, and OpenCode. `codedb nuke` removes the matching entries. Invalid JSON is left untouched.
- Antigravity registers only under `~/.gemini/antigravity/mcp_config.json`, not Gemini CLI's settings file. `codedb nuke` also removes the non-CN Trae `User/mcp.json` path.

## 0.2.5856 - 2026-09-19

- Skip `.worktrees` during indexing and listing so Git worktree forests cannot exhaust the macOS directory watch budget (#754). A scan root that is itself a worktree checkout is still indexed.
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ the map**: focused source context, symbols, callers, outlines, and dependencies.
Your coding client uses its own native tools to make the edit.

**A context engine, not an editor.** codedb has no edit capability. Use it with
Graff, Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin, or another MCP client.
Graff, Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin, oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, OpenCode, or another MCP client.

## 🧭 Give your agent a compass

Expand All @@ -62,7 +62,7 @@ embeddings**; choose `semantic=local` for local-only retrieval. See
curl -fsSL https://codedb.codegraff.com/install.sh | bash
```

Downloads the binary for your platform and auto-registers codedb as an MCP server in **Claude Code**, **Codex**, **Gemini CLI**, **Cursor**, **Windsurf**, and **Devin** — each written directly and additively into that tool's config (only when the tool is present). The installer prints the exact `codedb mcp` command it registered plus hook setup pointers for Codex and Claude Code.
Downloads the binary for your platform and auto-registers codedb as an MCP server in **Claude Code**, **Codex**, **Gemini CLI**, **Cursor**, **Windsurf**, **Devin**, **oh-my-pi**, **Hermes**, **Qwen Code**, **ZCode**, **Trae**, **Cline**, **Copilot CLI**, **Antigravity**, **Kiro**, and **OpenCode** — each written directly and additively into that tool's config (only when the tool is present). The installer prints the exact `codedb mcp` command it registered plus hook setup pointers for Codex and Claude Code.

On Windows, run this command inside WSL only if you want the Linux binary inside WSL. For the native Windows binary, use PowerShell below.

Expand Down Expand Up @@ -134,7 +134,7 @@ over stdio, with an optional localhost HTTP server.

## Documentation

- **[MCP setup](docs/mcp.md)** — per-client configurations (Claude Desktop, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI), root resolution, troubleshooting
- **[MCP setup](docs/mcp.md)** — per-client configurations (Claude Desktop, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, OpenCode), root resolution, troubleshooting
- **[Skill base & context files](docs/skills.md)** — `agents.md` / `CLAUDE.md` / `GEMINI.md`, `.codedbrc`, per-developer memory
- **[CLI reference](docs/cli.md)** — every command, every flag
- **[Architecture](docs/architecture.md)** — engine internals, index layout
Expand Down
2 changes: 1 addition & 1 deletion build.zig.zon
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.{
.name = .codedb2,
.fingerprint = 0x6e18d96ca2a31757,
.version = "0.2.5856",
.version = "0.2.5857",
.minimum_zig_version = "0.17.0-dev.813+2153f8143",
.dependencies = .{
.nanoregex = .{
Expand Down
171 changes: 166 additions & 5 deletions docs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,10 @@ curl -fsSL https://codedb.codegraff.com/install.sh | bash
The installer downloads the binary for your platform, drops it in `~/bin`
(or `$CODEDB_DIR` when set), and auto-registers
codedb as an MCP server in every client it can find — Claude Code, Codex,
Gemini CLI, Cursor, Windsurf, and Devin. It prints the exact `codedb mcp` command it
registered.
Gemini CLI, Cursor, Windsurf, Devin, oh-my-pi, Hermes, Qwen Code, ZCode,
Trae, Cline, Copilot CLI, Antigravity, Kiro, and OpenCode. It prints the exact `codedb mcp` command it
registered. Only clients that already look installed (config dir or CLI on
`PATH`) are touched.

### Windows x86_64 (native)

Expand Down Expand Up @@ -126,10 +128,9 @@ codex mcp add codedb -- /absolute/path/to/codedb mcp
codex mcp add codedb -- "$env:LOCALAPPDATA\Programs\codedb\codedb.exe" mcp
```

### Gemini CLI / opencode
### Gemini CLI

Both read MCP configuration from `~/.gemini/mcp.json` (Gemini) and
`~/.config/opencode/mcp.json` (opencode):
Edit `~/.gemini/settings.json`:

```json
{
Expand All @@ -142,6 +143,166 @@ Both read MCP configuration from `~/.gemini/mcp.json` (Gemini) and
}
```

### oh-my-pi

User config is `~/.omp/agent/mcp.json` (or `~/.omp/profiles/<name>/agent/mcp.json`
when a named profile is active):

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### Hermes

Add a stdio server under `mcp_servers` in `~/.hermes/config.yaml`:

```yaml
mcp_servers:
codedb:
command: "/absolute/path/to/codedb"
args: ["mcp"]
```

### Qwen Code

Edit `~/.qwen/settings.json`:

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### ZCode

User config is `~/.zcode/cli/config.json` (`mcp.servers`):

```json
{
"mcp": {
"servers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
}
```

### Trae / TraeCode

User-level: `~/.trae/mcp.json`. Trae IDE also reads
`~/Library/Application Support/Trae/User/settings/mcp.json` (macOS) or
`%APPDATA%\Trae\User\settings\mcp.json` (Windows):

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### Cline

CLI/SDK: `~/.cline/data/settings/cline_mcp_settings.json`. The VS Code/Cursor
extension uses the same `mcpServers` object in its `cline_mcp_settings.json`:

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### GitHub Copilot CLI

Edit `~/.copilot/mcp-config.json`, or run
`copilot mcp add codedb -- /absolute/path/to/codedb mcp`:

```json
{
"mcpServers": {
"codedb": {
"type": "local",
"command": "/absolute/path/to/codedb",
"args": ["mcp"],
"tools": ["*"]
}
}
}
```

### Google Antigravity

Global config is `~/.gemini/config/mcp_config.json` (older IDE builds also
read `~/.gemini/antigravity/mcp_config.json`):

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### Kiro

User config is `~/.kiro/settings/mcp.json`:

```json
{
"mcpServers": {
"codedb": {
"command": "/absolute/path/to/codedb",
"args": ["mcp"]
}
}
}
```

### OpenCode

Edit `~/.config/opencode/opencode.json`. Current OpenCode uses a `mcp` map
with `type: "local"` and a command array (v2 nested `mcp.servers` is also
accepted):

```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codedb": {
"type": "local",
"command": ["/absolute/path/to/codedb", "mcp"],
"enabled": true
}
}
}
```

### Tool profile (smaller tools/list)

Agent harnesses default to `CODEDB_TOOLS_PROFILE=mini`: five one-shot tools
Expand Down
20 changes: 20 additions & 0 deletions docs/releases/0.2.5857.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# CodeDB 0.2.5857

The installer now registers codedb in the MCP clients it can already detect, instead of leaving ten of them for a hand edit.

## More MCP clients

0.2.5856 and earlier auto-registered Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Devin. Agents on oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, and OpenCode still had to paste a config snippet.

The installer writes each client's documented file and schema when that client's config directory or CLI is already present. Malformed JSON is left untouched rather than replaced. `codedb nuke` removes the same entries.

Antigravity does not share Gemini CLI's settings file. Registration and Deepwiki go only to `~/.gemini/antigravity/mcp_config.json`. The stray `~/.gemini/config/mcp_config.json` path stays in nuke so an older install still deregisters. Nuke also removes the non-CN Trae `User/mcp.json` path the installer can create.

Retrieval, the watcher, and hosted embeddings are unchanged.

## Verification

```sh
zig test src/test_mcp.zig --test-filter 'nuke:'
zig test src/test_mcp.zig --test-filter 'installers:'
```
Loading
Loading