ahmadawais

ahmadawais / excalidraw-cli

Public

excalidraw-cli — Create hand-drawn Excalidraw diagrams from the command line. Generate .excalidraw files, manage diagram checkpoints, export to excalidraw.com, and reference the complete element format — all without leaving your terminal.

x.comMrAhmadAwais
38
4
100% credibility
Found Feb 13, 2026 at 16 stars 2x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This tool lets everyday people create, version, and share hand-drawn style diagrams from simple text descriptions right in their terminal.

How It Works

1
🔍 Discover easy diagram maker

You hear about a simple way to create hand-drawn looking diagrams just by describing them in text, perfect for flowcharts and ideas without drawing apps.

2
📥 Set it up on your computer

With one quick download, you add this handy tool to your computer so it's ready whenever you need to make diagrams.

3
✏️ Describe your diagram

You list out boxes, arrows, and text in a straightforward way, and it instantly turns them into a pretty hand-drawn diagram file.

4
💾 Save versions of your work

You capture snapshots of your diagram at different stages, so you can go back and tweak or restore earlier ideas anytime.

5
Share or get inspired
🌐
Share online

Upload it to a website to get a link anyone can view and edit your hand-drawn creation.

📖
Check examples

Look at a guide of shapes and colors to spark new ideas for your next diagram.

🎉 Admire your creation

You now have beautiful, sketchy diagrams ready to use in notes, presentations, or share with friends and team.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 38 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is excalidraw-cli?

Excalidraw-cli is a TypeScript command-line tool for generating hand-drawn Excalidraw diagrams straight from your terminal. Pipe in JSON elements via stdin, file, or inline flag to create complete .excalidraw files with auto-applied sloppy roughness, rounded shapes, and handwritten fonts—no browser required. It handles checkpoints for diagram versioning, exports to shareable excalidraw.com links, and prints a full element format reference.

Why is it gaining traction?

Unlike browser-only Excalidraw, this CLI enables scripting diagrams for docs, CI/CD, or AI agents, with smart defaults cutting JSON verbosity via label shorthands and arrow bindings. Checkpoint commands let you save, load, list, or delete states like git for visuals, while brute export delivers clickable links instantly. The reference command outputs color palettes, dark mode setups, and binding tips, making complex flows like ClickHouse queries or ClickUp workflows trivial from CLI.

Who should use this?

Backend devs visualizing API flows or database schemas without GUI distractions, AI engineers piping prompts to diagrams in local clients, technical writers embedding auto-generated charts in READMEs. Suited for ClickHouse viz, ClickUp boards, clipboard copies, or any terminal-heavy workflow needing quick, editable Excalidraw diagrams.

Verdict

With 14 stars and 1.0% credibility score, it's early-stage but boasts polished docs, real-world examples, and Vitest coverage—mature enough for scripts today. Use it for CLI diagram creation if you hate context-switching; skip if you need heavy collaboration features.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.