Projects

Open-source tools that give coding agents the context and the checks they need on large and legacy codebases, and the diagram tooling that grew up around them.

Everything here is open source at github.com/grahambrooks. Each project page lists the posts about it — how it came about, what it gets wrong, and what changed in each release.

Context for agents

symgraph

A knowledge-graph MCP server that gives coding agents a map of a codebase — symbols, calls, imports, coupling — and says when it isn't sure. It started life as codemap.

5 posts · GitHub

bx

Runs local MCP servers as native binaries, the way npx or uvx run packages, but without a Node or Python runtime on the machine.

2 posts · GitHub

casual-review

A code review CLI with rustc-style diagnostics for other languages, built for both human reviewers and agents, on a workstation or in CI.

1 post · GitHub

Architecture checks

tropism

Architecture rules an agent can check inside the edit loop: import cycles, layering and manifest problems across ten languages, with no build and no network.

1 post · GitHub

brake

Fails the commit when an API change would break a consumer, across OpenAPI, protobuf and GraphQL, from one CLI and one ruleset.

1 post · GitHub

Diagrams and models

forge

Describe an architecture — structure, processes, deployment and data — in one .forge file, then render diagrams, generate documentation and lint it.

3 posts · GitHub

mmd

Renders Mermaid diagrams to SVG in pure Rust — no Node, no browser — with real text labels, so the output survives conversion to PDF.

1 post · GitHub

puml

Renders PlantUML diagrams in pure Rust — sequence, class, activity and state, among others.

2 posts · GitHub

diagram-scene

A Rust library that describes a laid-out diagram as plain data — shapes, containers, routed edges, theme roles — shared by mmd, puml and forge.

3 posts · GitHub

adoc

An AsciiDoc processor in Rust, with HTML5 output and a serializable AST.

1 post · GitHub

infographic

A Claude Code skill and Rust CLI that turns a one-line request into an animated SVG explaining a technical pattern, and checks the result.

1 post · GitHub

backstage-catalog-graph

VS Code and JetBrains plugins that draw a Backstage catalog-info.yaml as a graph, with placeholders for every reference that leaves the file.

1 post · GitHub

bsv

Browse and visualize a Backstage catalog without running Backstage.

1 post · GitHub

rv

Generates force-directed SVG graphs of a directory structure.

1 post · GitHub

Developer tools

increment

A terminal diff viewer built around the aligned side-by-side view, with a browser for walking a branch commit by commit.

1 post · GitHub

teleplot

Kibana dashboards without Kibana: one read-only binary over Elasticsearch, with an MCP endpoint so agents can write the dashboards.

2 posts · GitHub

facts

A Rust testing library after Clojure's Midje: assertions read left to right, actual => expected.

1 post · GitHub