CLI-Anything >-

install

source · Clone the upstream repo

git clone https://github.com/HKUDS/CLI-Anything

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/HKUDS/CLI-Anything "$T" && mkdir -p ~/.claude/skills && cp -r "$T/pm2/agent-harness/cli_anything/pm2/skills" ~/.claude/skills/hkuds-cli-anything-03b6ea && rm -rf "$T"

manifest: pm2/agent-harness/cli_anything/pm2/skills/SKILL.md

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