Excalidraw Diagram CLI
Generate Excalidraw diagrams — flowcharts, sequences, architecture — as valid .excalidraw JSON.
Keywords: excalidraw, diagrams, flowchart, architecture, cli, drawing, python, open-source, agent, automation, MIT
Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.
What it does
Drawing diagrams by hand is slow and not version-controllable. Excalidraw Diagram CLI solves this: Generate Excalidraw diagrams — flowcharts, sequences, architecture — as valid .excalidraw JSON.
Best for: Engineers documenting architecture, agents generating diagrams, and tech writers.
Features
- Generate a flowchart
- Build a sequence diagram
- Compose an architecture map
- Merge/overlay diagrams
- Export valid Excalidraw JSON
Install
# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/excalidraw-cli/main/excalidraw_cli.py
# Or copy the file anywhere — it's self-contained.
Quick start
python excalidraw_cli.py self-test # prove it works end-to-end
python excalidraw_cli.py diagram --help # diagram subcommand
python excalidraw_cli.py merge --help # merge subcommand
python excalidraw_cli.py info --help # info subcommand
python excalidraw_cli.py export --help # export subcommand
Use cases
- Generate a flowchart
- Build a sequence diagram
- Compose an architecture map
- Merge/overlay diagrams
- Export valid Excalidraw JSON
Why choose this over alternatives
| Alternative | Why this skill is better |
|---|---|
| Drag-drop in Excalidraw | Diagrams as code, diff-able in git. |
| Mermaid only | Native Excalidraw JSON, hand-drawn style. |
| Screenshots | Regenerate from text anytime. |
FAQ (SEO / AEO)
Q: Diagram types?
A: flow, sequence, architecture (--type).
Q: Valid output?
A: Emits Excalidraw-compatible JSON you can open in the app.
Q: Compose?
A: merge/overlay combine diagrams.
Q: Offline?
A: Yes.
Geo / local reach
Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.
CI integration
# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Self-test excalidraw-cli
run: python excalidraw_cli.py self-test
Support
Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful:
- GitHub Sponsors: https://github.com/sponsors/itsPremkumar
- Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar
⭐ Star on GitHub