agents / diagram-crafter

Diagram Crafter

A diagram agent that turns an initial text into a polished explanatory visual, hand-crafted as SVG. It scopes the single claim the diagram must make, proposes 2-3 ASCII wireframe compositions built from proven archetypes, and expands the chosen one using a written design system so results stay consistent across runs. The user decides composition; the design system decides style. Finished diagrams accumulate in a library the agent consults on later runs.

diagramsvisualscommunication
1
Set up gcontext

One-time setup. Already have a gcontext instance? Skip to step 2 ↓

a/Install uv
$curl -LsSf https://astral.sh/uv/install.sh | sh
b/Install gcontext What is gcontext? →
$uv tool install gcontext-ai
c/Create your instance
$gcontext init my_instance

This creates a folder named my_instance. Every step below runs inside it.

2
Install the agent
a/Add the agent to your instance
$cd <instance_name>
$gcontext add diagram-crafter

<instance_name> is the folder from step 1 (e.g. my_instance).

b/Start the server
$gcontext up .
c/Connect your client
connect (once per client)
Claude Code
Cursor
Codex
claude mcp add --transport http <instance_name> http://127.0.0.1:4242/mcp
"<instance_name>": {"url": "http://127.0.0.1:4242/mcp"} in ~/.cursor/mcp.json
[mcp_servers.<instance_name>] url = "http://127.0.0.1:4242/mcp" in ~/.codex/config.toml
Full steps per client:gcontext connect

Claude Desktop: add the server URL to claude_desktop_config.json manually.

d/Run setup inside your client
/mcp__<instance_name>__diagram_crafter__setup

Setup personalizes the agent inside your client; it asks what the agent should do.

3
First steps
a/Ask the agent
terminal
$ /mcp__<instance_name>__diagram_crafter__<command> task: <describe what you want done>
working ...
View on GitHub