Context windows fragment
A model can read a few files, but it rarely keeps the whole dependency story in view during long-running engineering work.
AI-native graph platform
A persistent engineering workspace that turns repositories into deterministic symbol graphs, repo maps, and read-only context tools for AI coding agents.
Why CodeMind Graph
Large repositories overwhelm context windows, hide architecture behind file trees, and lose decisions between sessions. CodeMind Graph turns repository structure into a persistent knowledge layer that both humans and agents can inspect.
A model can read a few files, but it rarely keeps the whole dependency story in view during long-running engineering work.
Similarity search helps discovery, but it does not provide deterministic symbol ownership, import paths, or module boundaries.
Decisions, generated maps, and handoff state become unreliable when they are not grounded in the current repository graph.
Files, modules, symbols, imports, exports, and traces become addressable graph entities instead of loose text chunks.
Repository intelligence is generated locally and stored under `.codemind/`, preserving privacy and low-latency lookup.
Repo maps and read-only MCP tools give agents stable context across sessions without exposing private engineering notes.
Workspace graph
CodeMind Graph maps files, modules, symbols, imports, exports, and agent-facing context into one deterministic workspace layer.
Engineering practices
CodeMind Graph treats structured context as a first-class engineering artifact. The product is built around deterministic graphs, privacy-preserving local processing, and read-only agent integration.
The repository is shaped for agents as well as humans: commands are deterministic, outputs are diffable, and context is structured.
Source analysis runs on the developer machine. Generated graph data stays local unless the owner explicitly publishes a public demo.
MCP tools are read-only by default and do not expose session notes, private docs, environment variables, or write operations.
The persisted graph, repo map, and docs-as-state files make long-running engineering sessions resumable and auditable.
Architecture standard
The v0.1 architecture starts with a TypeScript Compiler API adapter, a deterministic core graph model, a CLI-first query surface, and a read-only MCP server.
Brand positioning
CodeMind Graph is designed for large repositories, AI agents, and persistent engineering work. It combines graph-driven code intelligence with local-first safety.
Core capabilities
Represent project structure as readable nodes and relationships instead of raw file dumps.
Give agents stable symbol and dependency context before they modify large codebases.
Keep decisions, state, and generated repo maps separate from private source code exposure.
Prepare one shared graph context for implementer, evaluator, and librarian workflows.
Design the repo itself as an agent-readable workspace with deterministic command output.
Move from approximate search to structured navigation across symbols and modules.
Agent workflow
Scan TypeScript sources and write .codemind/graph.json.
Generate CODEMIND.md for human and agent review.
Expose read-only MCP tools for targeted graph retrieval.
Use graph structure to guide persistent engineering sessions.
Developer-first
CodeMind Graph is built for local-first engineering. Generate the graph, inspect symbols, and expose safe read-only context to your agent workflow.
pnpm check && node packages/cli/dist/index.js map --root examples/ts-basic --format markdownGitHub