Hermes Atlas
Developer tools & SDKs · works with Hermes Agent

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

In short

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/project

Requirements: 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 tools

Related guides: How to install Hermes Agent · Run multiple Hermes agents with profiles