What is DevGraph?
DevGraph is a universal context layer for codebases. It scans Markdown files for service definitions, builds a project graph, and generates outputs likegraph.json, summary.md, and agent-specific context files.
One command to map your entire architecture—for humans and AI alike.
Key Features
Markdown-First
Define services, APIs, and environment variables in fenced code blocks within your existing docs.
Visual Graph
Launch DevGraph Studio to explore your architecture interactively.
AI-Ready Outputs
Generate per-service context files optimized for LLMs and AI agents.
Mermaid Diagrams
Auto-generate dependency and codebase structure diagrams.
Generated Outputs
When you rundevgraph build, the following files are created in .devgraph/:
| File | Description |
|---|---|
graph.json | Machine-readable project graph |
summary.md | Human-readable overview with tables |
agents/*.md | Per-service context files for LLMs |
system.mmd | Mermaid diagram of service dependencies |
codemap.mmd | Mermaid diagram of repo structure |