claude-d2-diagrams
A Claude Code plugin that generates infrastructure and architecture diagrams (and documentation) from your codebase using D2.
Command: /d2:diagram
Example Output
Infrastructure (Simplified)
Architecture (Simplified)
More advanced/complex outputs will be generated as well.
Files generated:
diagrams/
├── README.md <-- Will contain embedded diagrams
├── architecture-dark.svg
├── architecture-light.svg
├── architecture-simplified-dark.svg
├── architecture-simplified-light.svg
├── architecture-simplified.d2
├── architecture-simplified.md
├── architecture.d2
├── architecture.md
├── infrastructure-dark.svg
├── infrastructure-light.svg
├── infrastructure-simplified-dark.svg
├── infrastructure-simplified-light.svg
├── infrastructure-simplified.d2
├── infrastructure-simplified.md
├── infrastructure.d2
└── infrastructure.md
Features
- Scans Terraform, Kubernetes, Docker, CloudFormation, and code patterns
- 100+ icons (AWS, GCP, Azure, K8s, databases, languages)
- Dark/light theme support
- Animated traffic flow (respects
prefers-reduced-motion) - Self-contained SVGs with embedded icons
- D2 syntax validation with auto-fix
Installation
git clone https://github.com/heathdutton/claude-d2-diagrams.git
claude --plugin-dir ./claude-d2-diagrams
# or
claude plugin marketplace add https://github.com/heathdutton/claude-d2-diagrams
claude plugin install d2@claude-d2-diagrams
Requires D2:
brew install d2 # macOS
# or
curl -fsSL https://d2lang.com/install.sh | sh -s -- # Linux
Note: the plugin will guide you through installing D2 if not available.
Usage
/d2:diagram # Full generation
/d2:diagram --incremental # Only regenerate changes
/d2:diagram --infrastructure-only # Skip architecture
/d2:diagram --architecture-only # Skip infrastructure
/d2:diagram --scope=src/ # Limit scan to directory
Customization
Create ./diagrams/rules.md to customize. Example:
## Naming
- Use "API Gateway" not "APIGW"
## Exclude
- test/
- examples/
## Include (even if not in IaC)
- Cloudflare CDN
- Datadog monitoring
License
MIT