name: "cli-anything-pm2"
description: >-
Command-line interface for PM2 - A stateless CLI for Node.js process management via the PM2 CLI. List, start, stop, restart processes, view logs, and manage system configuration.

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:

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

Version#

1.0.0