claude-d2-diagrams

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