cli-anything-pm2

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

Installation

pip install -e .

Prerequisites:

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

Usage

Basic Commands

# 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 Mode

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

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

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

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

logs

Log management commands.

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

system

System-level commands.

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

Output Formats

All commands support dual output modes:

• Human-readable (default): Tables, colors, formatted text
• Machine-readable (--json flag): Structured JSON for agent consumption

# Human output
cli-anything-pm2 process list

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

For AI Agents

When using this CLI programmatically:

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

Version

1.0.0