CREED

Creed

**A knowledge graph of your codebase, for AI coding agents.**

[](https://www.npmjs.com/package/creed-kg) [](LICENSE) [](https://nodejs.org)

Creed parses your project with Tree-sitter, resolves imports, calls, inheritance and type usage across files, and stores the result as a SQLite index.

Your agent then asks one question in plain English and gets one answer back: the symbols involved, what depends on them, the exact call sites, and the source — already attached. No greps, no follow-up file reads. On this repo that's [2–18× fewer tokens](#performance) than the grep-and-read loop it replaces.

---

Quick start

Requires **Node 22+**.

npm install -D creed-kg
npx creed-kg init

Restart your editor and your agent has the tool.

`init` indexes the repo, writes MCP config for whichever editors it finds, and adds `.creed/` to your `.gitignore`. It merges rather than overwrites, and re-running it is a no-op. Use `--all` for every supported editor, or `--editor cursor` for one.

After that a file watcher keeps the index current, re-parsing only what changed. There is no re-index command.

Configuring an editor by hand

Same block everywhere, with no project path to fill in — Creed walks up from wherever it's launched to find the root:

{
  "mcpServers": {
    "creed": {
      "command": "npx",
      "args": ["-y", "creed-kg", "mcp"]
    }
  }
}

Editor	Where it goes
Claude Code	.mcp.json — or claude mcp add creed -- npx creed-kg mcp
Cursor	.cursor/mcp.json or ~/.cursor/mcp.json
Kiro	.kiro/settings/mcp.json
Gemini CLI	.gemini/settings.json
VS Code / Copilot	.vscode/mcp.json — key is servers, not mcpServers
Claude Desktop	`npx cree