excalidraw

# Excalidraw Diagrams ## Overview Generate `.excalidraw` JSON files and export to PNG/SVG. **Two export options:** - **Kroki API** (`curl`) — zero install, SVG output only - **excalidraw-brute-export-cli** — local Firefox-based, PNG + SVG **Supported formats:** PNG (local CLI only), SVG (both options). PDF is NOT supported. ## When to Use **Explicit triggers:** user says "画图", "diagram", "visualize", "flowchart", "draw", "架构图", "流程图" **Proactive triggers:** - Explaining a system with 3+ interacting components - Describing a multi-step process or decision tree - Comparing architectures or approaches side by side **Skip when:** a simple list or table suffices, or user is in a quick Q&A flow **When NOT to use it — route elsewhere:** - Polished, precise diagrams, strict UML, or branded vendor icons → **drawio**. - Diagrams-as-code in git, auto-laid-out from text → **mermaid** (general) or **plantuml** (UML). - An infinite-canvas whiteboard or programmatic freehand strokes → **tldraw**. ## Prerequisites ### Option A: Kroki API (recommended — zero install, SVG only) ```bash # Just needs curl (pre-installed on macOS/Linux/Windows Git Bash) curl --version ``` No additional setup. SVG rendered via `https://kroki.io`. ### Option B: Local CLI (required for PNG) The CLI uses **Firefox** (not Chromium). Check and install: ```bash npm install -g excalidraw-brute-export-cli npx playwright install firefox ``` **macOS patch (one-time, required):** ```bash CLI_MAIN=$(npm root ...