agentskillexchange Generate clickable architecture diagrams from public GitHub repos with GitDiagram
Turn a public GitHub repository into an interactive architecture diagram before onboarding, code review, or agent handoff.
Prerequisites
Public GitHub repository URL, web access, optional self-hosted OpenAI or OpenRouter configuration
Installation
Use the upstream install or setup path that matches your environment:
- git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
- docker-compose up --build -d
- docker-compose logs -f api
Requirements and caveats from upstream:
- That graph is validated against the actual file tree, retried with feedback if it contains bad paths or invalid connections, then compiled into Mermaid and validated again before it is shown. Any node tied to a real p...
- This keeps the backend's Python environment managed by uv and installs the backend Mermaid validator's Bun dependencies from backend/bun.lock.
Basic usage or getting-started notes:
One implementation detail worth knowing: the Next backend validates Mermaid in-process in src/server/generate/mermaid-validator.ts, whil...
bun run install:backend
cp .env.example .env
Extracted from upstream docs: https://raw.githubusercontent.com/ahmedkhaleel2004/gitdiagram/HEAD/README.md