Code Knowledge Graph
ishandutta2007/Code-Knowledge-Graph
Local code indexer that maps a codebase into a graph and serves it to coding agents over MCP
Code Knowledge Graph is a TypeScript tool that indexes a codebase into a graph of classes, functions and dependencies so AI coding agents can query it instead of crawling files. It lists Hermes Agent among its supported agents and includes an MCP server.
What Code Knowledge Graph does
Code Knowledge Graph, abbreviated GKG in the README, indexes a project locally and records classes, functions and dependencies as a structured graph. An agent can then ask for specific symbols and get focused snippets instead of reading whole files. The README states that indexing is done locally with no API calls, and that code stays on your machine.
Usage is through npm scripts: npm run ckg -- index ./path/to/your/project builds the graph, npm run ckg -- query SymbolName looks up a symbol, and npm run mcp starts an MCP server. The README shows a mcpServers entry for claude_desktop_config.json that launches the server with node and ts-node. Its compatibility table names Claude Code, Cursor, Codex, OpenCode and Hermes Agent, and gives Hermes Agent a 'Native Protocol' integration method without further detail.
Key features
- Graph index of classes, functions and dependencies
- Local indexing with no API calls
- Command-line commands to index a project and query a symbol
- MCP server started with npm run mcp
- Compatibility list covering Claude Code, Cursor, Codex, OpenCode and Hermes Agent
When to use it
- Giving a coding agent a symbol lookup instead of letting it crawl every file
- Finding where a function or class is defined from the command line
- Sharing one local code index across several coding agents
Who it is for: Developers who use Hermes Agent or other coding agents on large repositories and want a local code index.
How it fits with Hermes Agent
Supports Hermes Agent among several agents; the README lists Hermes Agent in its compatibility table, but the documented setup is a generic MCP server entry.
How to install Code Knowledge Graph
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
git clone https://github.com/ishandutta2007/Code-Knowledge-Graph.git
cd Code-Knowledge-Graph
npm install
npm run ckg -- index ./path/to/your/projectRequirements: Node.js with npm (the setup uses npm install and npm run scripts)
FAQ
What is Code Knowledge Graph?
Code Knowledge Graph is a local indexing tool that maps a codebase into a graph of classes, functions and dependencies. AI coding agents can query that graph, directly or through its MCP server, instead of reading every file.
Does Code Knowledge Graph work with Hermes Agent?
According to the README, yes: it lists Hermes Agent among supported agents with a 'Native Protocol' integration method. The documented setup is a generic MCP server entry rather than Hermes-specific steps.
How do I install Code Knowledge Graph?
Clone the repository, run npm install, then index a project with npm run ckg -- index ./path/to/your/project. Start the MCP server with npm run mcp and add it to your agent's MCP configuration.
Similar dev tools for Hermes Agent
All dev toolsOpen HTTP protocol for human decisions in agent workflows, with review URLs and messenger buttons
lodado Playwright Spec for AI AgentCLI that has an AI agent judge a live staging page against your existing Playwright specs
barkley-assistant CaduceusRust daemon and Hermes plugin that reviews pull requests and turns labeled issues into PRs
Hypabolic TrajectoryLibrary that normalizes coding-agent session logs, Hermes included, into stable records in four languages
frgmstr Hermes ManagerShareable meta-agent profile for managing Hermes profiles, skills, cron, memory and gateway health
ma-pony Remote Agent ServerSelf-hosted task API and web console for running Claude Code, Codex and Hermes agents
Related guides: How to install Hermes Agent · Run multiple Hermes agents with profiles