opencode-colbymchemry-codegraph

OpenCode server + TUI plugin for colbymchenry/codegraph.

Features

| Layer | Behavior | |---|---| | Server plugin | Injects CodeGraph MCP config, initializes missing repo index, syncs after edit-like tools | | TUI plugin | Shows CodeGraph state in sidebar: ready, initializing, syncing, missing binary, error | | Native tools | codegraph-plugin-status, codegraph-plugin-init, codegraph-plugin-sync |

Install

Add server plugin to opencode.json:

{
  "plugin": ["opencode-colbymchemry-codegraph"]
}

Add TUI plugin to tui.json:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-colbymchemry-codegraph"]
}

No npm install step required. opencode resolves plugin packages from config.

The plugin depends on @colbymchenry/codegraph and prefers its bundled binary. Set codegraphCommand only to use a custom binary.

Restart opencode after config changes.

Options

Tuple form:

{
  "plugin": [
    [
      "opencode-colbymchemry-codegraph",
      {
        "autoInit": "always",
        "autoSync": true,
        "injectMcp": true,
        "slimMcp": false,
        "codegraphCommand": "codegraph",
        "syncDebounceMs": 4000
      }
    ]
  ]
}

| Option | Default | Description | |---|---:|---| | autoInit | "always" | "always", "ask", "never"; true maps to "always", false maps to "never" | | autoSync | true | Debounced codegraph sync after edit/write/patch and common mutating shell commands | | injectMcp | true | Adds mcp.codegraph with codegraph serve --mcp; skipped for complete raw slim config | | slimMcp | false | Adds slim: true to injected MCP config for cfg-aware opencode-slim-mcp; requires plugin order below | | codegraphCommand | bundled binary, then "codegraph" | Custom binary name or absolute path | | syncDebounceMs | 4000 | Delay before post-edit sync |

MCP Config

By default, the server plugin injects this config when mcp.codegraph is missing or null:

{
  "mcp": {
    "codegraph": {
      "type": "local",
      "command": ["codegraph", "serve", "--mcp"],
      "enabled": true
    }
  }
}

If opencode.json already defines mcp.codegraph, the plugin shallow-merges it over the defaults. User values override defaults; plugin-only extension keys such as slim are stripped before opencode validates MCP config:

{
  "plugin": ["opencode-colbymchemry-codegraph"],
  "mcp": {
    "codegraph": {
      "command": ["/path/to/codegraph", "serve", "--mcp"],
      "env": {
        "CODEGRAPH_LOG": "debug"
      }
    }
  }
}

Effective config keeps default type and enabled, replaces command, and adds env.

Set injectMcp: false to disable automatic MCP injection.

Slim MCP

Current opencode-slim-mcp discovers slim servers from raw opencode.json, before this plugin injects defaults. Use a complete raw MCP entry:

{
  "plugin": [
    "opencode-slim-mcp",
    "opencode-colbymchemry-codegraph"
  ],
  "mcp": {
    "codegraph": {
      "slim": true,
      "type": "local",
      "command": ["codegraph", "serve", "--mcp"],
      "enabled": true
    }
  }
}

When complete raw slim config is present, this plugin does not re-inject mcp.codegraph after the slim plugin removes it. {"slim": true} without command or url falls back to normal MCP injection.

For a cfg-aware opencode-slim-mcp that scans cfg.mcp inside its config hook, use plugin order so CodeGraph injects first:

{
  "plugin": [
    [
      "opencode-colbymchemry-codegraph",
      { "slimMcp": true }
    ],
    "opencode-slim-mcp"
  ]
}

Do not enable slimMcp with current raw-config-only opencode-slim-mcp; opencode may reject the final slim key.

Status File

Server plugin writes one file per project path under:

~/.local/state/opencode/colbymchenry-codegraph/projects/<sha256(project-path)>.json

TUI plugin derives same path from current workspace directory and reads it via OpenCode file API, so local projects, separate repos, and separate worktrees stay isolated.

Development

npm install
bun run build

Local server plugin output is copied to .opencode/plugins/codegraph.js after build.