gabrielmoreira 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 (
--jsonflag): 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
--jsonflag for parseable output - Check return codes - 0 for success, non-zero for errors
- Parse stderr for error messages on failure
Version
1.0.0