CLI Anything Pm2
Apps & Automationcli-anything-pm2CLI Anything Pm2 is an Agent Skill for apps & automation published in the HKUDS/CLI-Anything repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/HKUDS/CLI-Anything/blob/HEAD/skills/cli-anything-pm2/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cli-anything-pm2, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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