cli-anything-pm2

cli-anything-pm2

PM2 プロセス管理用のステートレスなコマンドラインインターフェースです。 PM2 CLI サブプロセスを介して通信します。ローカル状態やセッションは持ちません。

インストール

pip install -e .

前提条件:

• Python 3.10 以上
• PM2 がグローバルにインストールされていること (npm install -g pm2)

使用方法

基本コマンド

# Show help
cli-anything-pm2 --help

# Start interactive REPL mode
cli-anything-pm2

# Run with JSON output (for agent consumption)
cli-anything-pm2 --json process list
cli-anything-pm2 --json system version

REPL モード

サブコマンドを指定せずに起動すると、CLI は対話型の REPL セッションに入ります:

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

コマンドグループ

process

プロセス検査コマンド。

コマンド	説明
list	すべての PM2 プロセスを一覧表示します
describe <name>	プロセスの詳細情報を取得します
metrics	すべてのプロセスのメトリクスを取得します

lifecycle

プロセスライフサイクルコマンド。

コマンド	説明
start <script> --name <name>	新しいプロセスを起動します
stop <name>	プロセスを停止します
restart <name>	プロセスを再起動します
delete <name>	プロセスを削除します

logs

ログ管理コマンド。

コマンド	説明
view <name> --lines 50	最近のログを表示します
flush [name]	ログをフラッシュします

system

システムレベルのコマンド。

コマンド	説明
save	現在のプロセスリストを保存します
startup	スタートアップスクリプトを生成します
version	PM2 のバージョンを取得します

出力形式

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

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

# Human output
cli-anything-pm2 process list

# JSON output for agents
cli-anything-pm2 --json process list

AI エージェント向け

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

1. 常に --json フラグを使用する - 解析可能な出力を得るため
2. リターンコードを確認する - 成功時は 0、エラー時は非ゼロ
3. 失敗時は stderr を解析する - エラーメッセージを取得するため

バージョン

1.0.0