📘 Khy-OS 文档站 🧭 新手先读：核心概念

# cli-anything-pm2

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:

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