hkuds/cli-anything

cli-anything-drawio

- Command-line interface for Drawio - A CLI harness for Draw.io — create, edit, and export diagrams from the command line....

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-drawio

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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:

bash
pip install cli-anything-drawio

Prerequisites:

  • Python 3.10+
  • drawio must be installed on your system

Usage

Basic Commands

bash
# Show help
cli-anything-drawio --help

# Start interactive REPL mode
cli-anything-drawio

# Create a new project
cli-anything-drawio project new -o project.json

# Run with JSON output (for agent consumption)
cli-anything-drawio --json project info -p project.json

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

bash
cli-anything-drawio
# Enter commands interactively with tab-completion and history

Command Groups

Project

Project management: new, open, save, info.

CommandDescription
newCreate a new blank diagram
openOpen an existing .drawio project file
saveSave the current project
infoShow detailed project information
xmlPrint the raw XML of the current project
presetsList available page size presets

Shape

Shape operations: add, remove, move, resize, style.

CommandDescription
addAdd a shape to the diagram
removeRemove a shape by ID
listList all shapes on a page
labelUpdate a shape's label text
moveMove a shape to new coordinates
resizeResize a shape
styleSet a style property on a shape
infoShow detailed info about a shape
typesList all available shape types

Connect

Connector operations: add, remove, style.

CommandDescription
addAdd a connector between two shapes
removeRemove a connector by ID
labelUpdate a connector's label
styleSet a style property on a connector
listList all connectors on a page
stylesList available edge styles

Page

Page operations: add, remove, rename, list.

CommandDescription
addAdd a new page
removeRemove a page by index
renameRename a page
listList all pages

Export

Export operations: render to PNG, PDF, SVG.

CommandDescription
renderExport the diagram to a file
formatsList available export formats

Session

Session management: status, undo, redo.

CommandDescription
statusShow current session status
undoUndo the last operation
redoRedo the last undone operation
save-stateSave session state to disk
listList all saved sessions

Examples

Create a New Project

Create a new drawio project file.

bash
cli-anything-drawio project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-drawio --json project new -o myproject.json

Interactive REPL Session

Start an interactive session with undo/redo support.

bash
cli-anything-drawio
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation

Export Project

Export the project to a final output format.

bash
cli-anything-drawio --project myproject.json export render output.pdf --overwrite

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
bash
# Human output
cli-anything-drawio project info -p project.json

# JSON output for agents
cli-anything-drawio --json project info -p project.json

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

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills