SkillPartly tested (needs an account)

Make editable Excalidraw diagrams

excalidraw-cli

Command-line tool and skill that turn a short text description into an editable Excalidraw flowchart or diagram, and export it as a PNG or SVG picture.

Works with
Claude Code, Codex CLI
Good for
Graphic designers, Daily work and research

What it does

Excalidraw is a free online whiteboard with a friendly hand-drawn look. excalidraw-cli is a small program that builds Excalidraw drawings from text, so your assistant can make a diagram for you instead of you dragging boxes around.

You describe what you want, for example the steps of an approval process. The skill writes a short text recipe where square brackets are steps, curly brackets are decisions and arrows connect them. The tool then lays the boxes out neatly by itself and saves a .excalidraw file.

You can open that file at excalidraw.com and keep editing it by hand, or ask for a PNG or SVG picture to paste into a document or slide. Dark mode, colours, dashed arrows and simple styling are supported.

Example prompts

  • The README and SKILL.md give no example prompts. SKILL.md says the skill is meant for requests for a flowchart, architecture diagram, decision tree or process visualization, or to export an existing .excalidraw file as PNG or SVG.

How to install

npm install -g @swiftlysingh/excalidraw-cli
npx skills add swiftlysingh/excalidraw-cli
/plugin marketplace add swiftlysingh/excalidraw-cli
/plugin install excalidraw-cli@excalidraw-cli

How to use it

Ask your assistant for a flowchart, process map or decision tree. The skill writes a .excalidraw file you can open and edit at excalidraw.com, and can export it as PNG or SVG.

Check it works

After a global install, excalidraw-cli create --inline "(Start) -> [Process] -> {Decision?}" -o flow.excalidraw (from the README) should create flow.excalidraw in the current folder, and excalidraw-cli --version should print 1.5.0. In Claude Code, the /plugin menu should list excalidraw-cli as installed after the plugin install.

Common problems

Other assistants

What to watch out for

  • Versions: npm latest is 1.5.0 (2026-10-18). The skill, the Claude Code plugin and the Gemini CLI extension are not in any release: npx skills add and both /plugin lines install from the GitHub main branch, where package.json, plugin.json and gemini-extension.json say 1.5.1 and CHANGELOG.md says Unreleased. The diagram code on main is the same as in npm 1.5.0
  • The skill has no disable-model-invocation, so your assistant can use it by itself for any flowchart, architecture diagram or decision tree request
  • Runs shell commands: the skill calls excalidraw-cli, or npx --yes @swiftlysingh/excalidraw-cli without a version, which downloads the newest npm release when the tool is not installed
  • create and convert replace an existing file with the same name without asking (default name flowchart.excalidraw); the skill also writes small .dsl files in your folder
  • Data flow: we read the source. The tool makes no network requests of its own: export fonts come from the package, and image web addresses are skipped. Nothing goes to excalidraw.com or a share-link service; you open the file there yourself. Local images named in a diagram are read from disk and stored inside the .excalidraw file
  • Needs Node.js 20.19.0 or later
  • npx skills add uses the skills CLI (npm package skills, from Vercel Labs), which sends anonymous usage data unless you set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1

Licence and author

Licence
MIT
Author
swiftlysingh (Pushpinder Singh)
Source code
github.com/swiftlysingh/excalidraw-cli

How we tested it

We installed it on an empty test computer on 10 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.

Test level

The install lines were not run. No source file changed between the v1.5.0 tag and 2796608, so the code read is the code in npm 1.5.0.

Technical details of the test
Date
10 Nov 2026
Method
Reviewed by our team against the repository at 2796608 (main): README, SKILL.md, GEMINI.md, CHANGELOG.md, the plugin, marketplace and Gemini manifests, package.json and all files in src, plus the npm registry data for 1.5.0. Not installed or run.

Checked again on 10 Nov 2026

Alternatives

  • diagram-design — makes a diagram as one HTML page; excalidraw-cli makes an editable Excalidraw file
  • next-ai-drawio — draws live on a draw.io page in your browser; excalidraw-cli works from files on your computer
  • stack-diagram — focused on app architecture with service logos; excalidraw-cli covers general flowcharts

FAQ

  • Q: Do I need an Excalidraw account? A: No. The tool writes files on your computer; you can open them at excalidraw.com without signing in.
  • Q: Can it read Graphviz DOT files? A: Yes, with --format dot, or from a .dot or .gv file; subgraphs are flattened (README and SKILL.md).
  • Q: Is there a Homebrew install? A: Yes: brew install swiftlysingh/tap/excalidraw-cli (README).

Sources

  • github.com/swiftlysingh/excalidraw-cli
  • github.com/swiftlysingh/excalidraw-cli/blob/2796608/skills/excalidraw-cli/SKILL.md
  • github.com/swiftlysingh/excalidraw-cli/blob/2796608/CHANGELOG.md
  • github.com/swiftlysingh/excalidraw-cli/blob/2796608/.claude-plugin/plugin.json
  • npmjs.com/package/@swiftlysingh/excalidraw-cli