Excalidraw Cli

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

1. Generate a flowchart
2. Build a sequence diagram
3. Compose an architecture map
4. Merge/overlay diagrams
5. Export valid Excalidraw JSON

Why choose this over alternatives

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