cli-anything-pm2

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

cli-anything-pm2

A stateless command-line interface for PM2 process management. Communicates via the PM2 CLI subprocess. No local state or session.

一款用于PM2进程管理的无状态命令行界面。通过PM2 CLI子进程进行通信，无本地状态或会话。

Installation

安装

bash

pip install -e .

Prerequisites:

Python 3.10+
PM2 installed globally (
```
npm install -g pm2
```
)

bash

pip install -e .

前置要求：

Python 3.10及以上版本
全局安装PM2（执行
```
npm install -g pm2
```
）

Usage

使用方法

Basic Commands

基础命令

bash

undefined

bash

undefined

Show help

显示帮助

cli-anything-pm2 --help

Start interactive REPL mode

启动交互式REPL模式

cli-anything-pm2

Run with JSON output (for agent consumption)

以JSON格式输出（供Agent使用）

cli-anything-pm2 --json process list cli-anything-pm2 --json system version

undefined

cli-anything-pm2 --json process list cli-anything-pm2 --json system version

undefined

REPL Mode

REPL模式

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

bash

cli-anything-pm2

当不指定子命令调用时，该CLI会进入交互式REPL会话：

bash

cli-anything-pm2

Enter commands interactively with tab-completion and history

可通过交互式方式输入命令，支持自动补全和历史记录

undefined

undefined

Command Groups

命令分组

process

进程

Process inspection commands.

Command	Description
`list`	List all PM2 processes
`describe <name>`	Get detailed info for a process
`metrics`	Get metrics for all processes

进程检查命令。

命令	描述
`list`	列出所有PM2进程
`describe <name>`	获取指定进程的详细信息
`metrics`	获取所有进程的指标数据

lifecycle

生命周期

Process lifecycle commands.

Command	Description
`start <script> --name <name>`	Start a new process
`stop <name>`	Stop a process
`restart <name>`	Restart a process
`delete <name>`	Delete a process

进程生命周期命令。

命令	描述
`start <script> --name <name>`	启动新进程
`stop <name>`	停止指定进程
`restart <name>`	重启指定进程
`delete <name>`	删除指定进程

logs

日志

Log management commands.

Command	Description
`view <name> --lines 50`	View recent logs
`flush [name]`	Flush logs

日志管理命令。

命令	描述
`view <name> --lines 50`	查看近期日志
`flush [name]`	清空日志

system

系统

System-level commands.

Command	Description
`save`	Save current process list
`startup`	Generate startup script
`version`	Get PM2 version

系统级命令。

命令	描述
`save`	保存当前进程列表
`startup`	生成开机启动脚本
`version`	获取PM2版本

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

undefined

所有命令支持两种输出模式：

人类可读格式（默认）：表格、彩色文本、格式化内容
机器可读格式（
```
--json
```
参数）：供Agent使用的结构化JSON格式

bash

undefined

Human output

人类可读格式输出

cli-anything-pm2 process list

JSON output for agents

供Agent使用的JSON格式输出

cli-anything-pm2 --json process list

undefined

cli-anything-pm2 --json process list

undefined

For AI Agents

面向AI Agent的使用说明

When using this CLI programmatically:

Always use
--json
flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure

当以编程方式使用此CLI时：

始终使用
--json
参数以获得可解析的输出
检查返回码 - 0表示成功，非零表示错误
解析stderr以获取失败时的错误信息

Version

版本

1.0.0