cli-anything-drawio

cli-anything-drawio

Draw.io のための CLI ハーネス — コマンドラインから図の作成、編集、エクスポートができます。

インストール

この CLI は cli-anything-drawio パッケージの一部としてインストールされます:

pip install cli-anything-drawio

前提条件:

• Python 3.10+
• drawio がシステムにインストールされている必要があります

使用方法

基本コマンド

# 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 モード

サブコマンドなしで起動すると、CLI は対話型の REPL セッションに入ります:

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

コマンドグループ

Project

プロジェクト管理: new、open、save、info。

コマンド	説明
new	新しい空の図を作成します
open	既存の .drawio プロジェクトファイルを開きます
save	現在のプロジェクトを保存します
info	プロジェクトの詳細情報を表示します
xml	現在のプロジェクトの生の XML を出力します
presets	利用可能なページサイズプリセットを一覧表示します

Shape

図形の操作: add、remove、move、resize、style。

コマンド	説明
add	図に図形を追加します
remove	ID で図形を削除します
list	ページ上のすべての図形を一覧表示します
label	図形のラベルテキストを更新します
move	図形を新しい座標に移動します
resize	図形のサイズを変更します
style	図形にスタイルプロパティを設定します
info	図形に関する詳細情報を表示します
types	利用可能なすべての図形タイプを一覧表示します

Connect

コネクタの操作: add、remove、style。

コマンド	説明
add	2 つの図形の間にコネクタを追加します
remove	ID でコネクタを削除します
label	コネクタのラベルを更新します
style	コネクタにスタイルプロパティを設定します
list	ページ上のすべてのコネクタを一覧表示します
styles	利用可能なエッジスタイルを一覧表示します

Page

ページの操作: add、remove、rename、list。

コマンド	説明
add	新しいページを追加します
remove	インデックスでページを削除します
rename	ページの名前を変更します
list	すべてのページを一覧表示します

Export

エクスポートの操作: PNG、PDF、SVG にレンダリングします。

コマンド	説明
render	図をファイルにエクスポートします
formats	利用可能なエクスポート形式を一覧表示します

Session

セッション管理: status、undo、redo。

コマンド	説明
status	現在のセッションステータスを表示します
undo	最後の操作を元に戻します
redo	最後に元に戻した操作をやり直します
save-state	セッションの状態をディスクに保存します
list	保存されたすべてのセッションを一覧表示します

例

新しいプロジェクトの作成

新しい drawio プロジェクトファイルを作成します。

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

対話型 REPL セッション

undo/redo をサポートする対話型セッションを開始します。

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

プロジェクトのエクスポート

プロジェクトを最終的な出力形式にエクスポートします。

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

状態管理

CLI は次のようにセッション状態を保持します:

• Undo/Redo: 最大 50 レベルの履歴
• プロジェクトの永続化: プロジェクトの状態を JSON として保存/読み込み
• セッションの追跡: 変更と修正を追跡

出力形式

すべてのコマンドは 2 つの出力モードをサポートします:

• 人間が読みやすい形式 (デフォルト): テーブル、色、整形されたテキスト
• 機械が読み取り可能な形式 (--json フラグ): エージェントが利用するための構造化 JSON

# Human output
cli-anything-drawio project info -p project.json

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

AI エージェント向け

この CLI をプログラムから使用する場合:

1. 常に --json フラグを使用する — 解析可能な出力のため
2. リターンコードを確認する — 0 は成功、非ゼロはエラー
3. 失敗時は stderr を解析する — エラーメッセージのため
4. すべてのファイル操作に絶対パスを使用する
5. エクスポート操作後に出力が存在することを確認する

詳細情報

• 完全なドキュメント: パッケージ内の README.md を参照してください
• テストカバレッジ: パッケージ内の TEST.md を参照してください
• 方法論: cli-anything-plugin 内の HARNESS.md を参照してください

バージョン

1.0.0