cli-anything-mermaid
Command-line interface for Mermaid Live Editor - Create, edit, and render Mermaid diagrams via stateful project files and mermaid.ink renderer URLs. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI.
By hkuds · 441 installs
npx skills add hkuds/cli-anything --skill cli-anything-mermaid
Source repository · Upstream listing
cli anything mermaid
Create, edit, and render Mermaid diagrams via stateful project files and the mermaid.ink renderer. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI.
Installation
This CLI is installed as part of the cli anything mermaid package:
Prerequisites:
Python 3.10+
No external software required (rendering uses mermaid.ink cloud service)
Usage
Basic Commands
REPL Mode
When invoked without a subcommand, the CLI enters an interactive REPL session:
Command Groups
Project
Project lifecycle commands.
Command Description
new Create a new Mermaid project with optional sample preset and theme
open Open an existing Mermaid project file
save Save the current project to a file
info Show current project information
samples List available sample diagram presets
Diagram
Diagram source manipulation commands.
Command Description
set Replace the Mermaid source text (inline or from file)
show Print the current Mermaid source code
Export
Render and share commands.
Command Description
render Render the diagram to SVG or PNG via mermaid.ink
share Generate a Mermaid Live Editor URL for sharing
Session
Session state commands.
Command Description
status Show current session state
undo Undo the last diagram source change
redo Redo the last undone change
Examples
Create and Render a Flowchart
Create a Sequence Diagram
Share a Diagram
Interactive REPL Session
State Management
The CLI maintains session state with:
Undo/Redo : Revert or replay diagram source changes
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 render 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