DiagramPilot

Diagrams are repository files an AI coding agent can safely change, validate, and commit.

npx diagrampilot check
Dark developer interface showing repository files, source code, terminal output, and an architecture diagram preview for DiagramPilot.

DiagramPilot is a local-first, repo-native diagram compiler for AI coding agents. It turns local DiagramSpec files into review-stable SVG artifacts for software repositories, so diagrams can live in the repo, survive code review, and fail with repairable errors.

Bring your own repository.

DiagramPilot works where agents already work: in a checkout, next to source code, with artifacts a maintainer can review.

One command before review.

`diagrampilot check` discovers DiagramPilot source files, validates them, and reports stale same-stem SVG artifacts without rewriting the working tree.

If it breaks, it says where.

Repairable errors name the broken field so an AI coding agent can update the DiagramSpec file, validate again, and commit the repaired source plus rendered output.

MCP agent integration.

Run `diagrampilot mcp` to expose read-only schema, docs, examples, validation, check, export, render, and prompt helpers to local MCP clients.

Local repository path

Source files become reviewable artifacts.

Keep DiagramSpec source beside rendered output. Agents can validate changes locally before a maintainer reviews the commit.

Start with the checkout demo.

Validate the source, render the SVG, export text formats when needed, connect MCP-aware agents, and keep every diagram change reviewable.