cli-anything-mermaid

cli-anything-mermaid

ステートフルなプロジェクトファイルと mermaid.ink レンダラーを使用して、Mermaid 図を作成、編集、レンダリングします。GUI なしでフローチャート、シーケンス図、その他のビジュアライゼーションを生成する必要がある AI エージェントやパワーユーザー向けに設計されています。

インストール

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

pip install cli-anything-mermaid

前提条件:

• Python 3.10 以上
• 外部ソフトウェアは不要（レンダリングには mermaid.ink クラウドサービスを使用）

使用方法

基本コマンド

# Show help
cli-anything-mermaid --help

# Start interactive REPL mode
cli-anything-mermaid

# Create a new project
cli-anything-mermaid project new -o diagram.json

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

REPL モード

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

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

コマンドグループ

Project

プロジェクトのライフサイクルを管理するコマンドです。

コマンド	説明
new	オプションのサンプルプリセットとテーマを指定して新しい Mermaid プロジェクトを作成します
open	既存の Mermaid プロジェクトファイルを開きます
save	現在のプロジェクトをファイルに保存します
info	現在のプロジェクト情報を表示します
samples	利用可能なサンプル図プリセットを一覧表示します

Diagram

図のソースを操作するコマンドです。

コマンド	説明
set	Mermaid ソーステキストを置き換えます（インラインまたはファイルから）
show	現在の Mermaid ソースコードを出力します

Export

レンダリングと共有のコマンドです。

コマンド	説明
render	mermaid.ink 経由で図を SVG または PNG にレンダリングします
share	共有用の Mermaid Live Editor URL を生成します

Session

セッション状態のコマンドです。

コマンド	説明
status	現在のセッション状態を表示します
undo	最後の図ソースの変更を元に戻します
redo	最後に元に戻した変更をやり直します

例

フローチャートの作成とレンダリング

# Create a project with flowchart sample
cli-anything-mermaid project new --sample flowchart -o flow.json

# Replace diagram source
cli-anything-mermaid --project flow.json diagram set --text "graph TD; A-->B; B-->C;"

# Render to SVG
cli-anything-mermaid --project flow.json export render output.svg --format svg

シーケンス図の作成

# Create project with sequence sample
cli-anything-mermaid project new --sample sequence -o seq.json

# Set diagram from file
cli-anything-mermaid --project seq.json diagram set --file my_diagram.mmd

# Render to PNG
cli-anything-mermaid --project seq.json export render output.png --format png

図の共有

# Generate an editable Mermaid Live URL
cli-anything-mermaid --project flow.json export share --mode edit

# Generate a view-only URL
cli-anything-mermaid --project flow.json export share --mode view

対話型 REPL セッション

cli-anything-mermaid
# new flowchart
# set graph TD; A-->B; B-->C;
# render output.svg
# share
# quit

状態管理

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

• Undo/Redo: 図ソースの変更を元に戻す、またはやり直す
• プロジェクトの永続化: プロジェクト状態を JSON として保存/読み込み
• セッションの追跡: 変更と修正を追跡

出力形式

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

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

# Human output
cli-anything-mermaid project info

# JSON output for agents
cli-anything-mermaid --json project info

AI エージェント向け

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

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

詳細情報

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

バージョン

1.0.0