cli-anything-pm2 是做什麼的？
一個無狀態的命令列介面，用於管理 PM2 程序。 透過 PM2 CLI 子程序進行通訊，不儲存任何本地狀態或工作階段。
安裝
pip install -e .
先決條件：
- Python 3.10+
- 已全域安裝 PM2（
npm install -g pm2）
使用方式
基本指令
# 顯示說明
cli-anything-pm2 --help
# 啟動互動式 REPL 模式
cli-anything-pm2
# 以 JSON 輸出執行（供代理程式使用）
cli-anything-pm2 --json process list
cli-anything-pm2 --json system version
REPL 模式
當不帶子指令執行時，CLI 會進入互動式 REPL 工作階段：
cli-anything-pm2
# 以互動方式輸入指令，支援分頁補全與歷史記錄
指令群組
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 版本 |
輸出格式
所有指令皆支援雙重輸出模式：
- 人類可讀（預設）：表格、顏色、格式化文字
- 機器可讀（
--json旗標）：結構化 JSON，供代理程式使用
# 人類輸出
cli-anything-pm2 process list
# 供代理程式使用的 JSON 輸出
cli-anything-pm2 --json process list
給 AI 代理程式的建議
當以程式化方式使用此 CLI 時：
- 一律使用
--json旗標 以取得可解析的輸出 - 檢查回傳碼 – 0 表示成功，非零表示錯誤
- 解析標準錯誤輸出 以取得失敗時的錯誤訊息
版本
1.0.0