cli-anything-drawio
Command-line interface for Drawio - A CLI harness for **Draw.io** — create, edit, and export diagrams from the command line....
By hkuds · 585 installs
npx skills add hkuds/cli-anything --skill cli-anything-drawio
Source repository · Upstream listing
cli anything drawio
A CLI harness for Draw.io — create, edit, and export diagrams from the command line.
Installation
This CLI is installed as part of the cli anything drawio package:
Prerequisites:
Python 3.10+
drawio must be installed on your system
Usage
Basic Commands
REPL Mode
When invoked without a subcommand, the CLI enters an interactive REPL session:
Command Groups
Project
Project management: new, open, save, info.
Command Description
new Create a new blank diagram
open Open an existing .drawio project file
save Save the current project
info Show detailed project information
xml Print the raw XML of the current project
presets List available page size presets
Shape
Shape operations: add, remove, move, resize, style.
Command Description
add Add a shape to the diagram
remove Remove a shape by ID
list List all shapes on a page
label Update a shape's label text
move Move a shape to new coordinates
resize Resize a shape
style Set a style property on a shape
info Show detailed info about a shape
types List all available shape types
Connect
Connector operations: add, remove, style.
Command Description
add Add a connector between two shapes
remove Remove a connector by ID
label Update a connector's label
style Set a style property on a connector
list List all connectors on a page
styles List available edge styles
Page
Page operations: add, remove, rename, list.
Command Description
add Add a new page
remove Remove a page by index
rename Rename a page
list List all pages
Export
Export operations: render to PNG, PDF, SVG.
Command Description
render Export the diagram to a file
formats List available export formats
Session
Session management: status, undo, redo.
Command Description
status Show current session status
undo Undo the last operation
redo Redo the last undone operation
save state Save session state to disk
list List all saved sessions
Examples
Create a New Project
Create a new drawio project file.
Interactive REPL Session
Start an interactive session with undo/redo support.
Export Project
Export the project to a final output format.
State Management
The CLI maintains session state with:
Undo/Redo : Up to 50 levels of history
Project persistence : Save/load project state as JSON
Session tracking : Track modifications and changes
Output Formats
All commands support dual output modes:
Human readable (default): Tables, colors, formatted text
Machine readable ( json flag): Structured JSON for agent consumption
For AI Agents
When using this CLI programmatically:
1. Always use json flag for parseable output
2. Check return codes 0 for success, non zero for errors
3. Parse stderr for error messages on failure
4. Use absolute paths for all file operations
5. Verify outputs exist after export operations
More Information
Full documentation: See README.md in the package
Test coverage: See TEST.md in the package
Methodology: See HARNESS.md in the cli anything plugin
Version
1.0.0