# cli-anything-pm2

A skill that brings PM2 CLI into Claude Code for managing Node.js processes. Start, stop, restart applications and tail logs directly from the editor.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 491 installs · ★ 57187
- Author: HKUDS
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-pm2/SKILL.md
- Updated: 2026-09-22
- HTML: https://affpapa.org/en/nevibecode/skills/cli-anything-pm2

## What it does

cli-anything-pm2 is a stateless interface to PM2 that works via subprocess. The skill provides four command groups: process (list processes, describe, metrics), lifecycle (start, stop, restart, delete), logs (view, flush), and system (save config, startup script, version).

Output comes in two modes: human-readable tables and colored text by default, or structured JSON with the `--json` flag for programmatic use. The skill also supports interactive REPL mode with tab-completion and command history.

You need Python 3.10+ and PM2 installed globally (`npm install -g pm2`). The skill is stateless — it keeps no local state and only talks to PM2 through its CLI.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-pm2 -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cli-anything-pm2/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cli-anything-pm2/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-pm2 -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cli-anything-pm2/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-pm2 -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cli-anything-pm2/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HKUDS/CLI-Anything cli-anything-pm2
```

2. **Manually: put the files in place**
- File: `.github/skills/cli-anything-pm2/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-pm2 -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-pm2
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cli-anything-pm2/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-pm2 -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-pm2/SKILL.md

## When to use it
- List running Node.js processes and their metrics
- Start a new application under PM2 with a custom name
- Stop or restart a process without SSH access
- View recent logs and flush them
- Generate a startup script for process auto-boot

## Example prompts
- show all PM2 processes and their current status
- start the app from index.js and call it my-app
- restart the server process and display its recent logs

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 271972dff2022eaf.

BEGIN THIRD-PARTY FILE 271972dff2022eaf
````text
---
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

```bash
pip install -e .
```

**Prerequisites:**
- Python 3.10+
- PM2 installed globally (`npm install -g pm2`)

## Usage

### Basic Commands

```bash
# 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:

```bash
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

```bash
# 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
````
END THIRD-PARTY FILE 271972dff2022eaf

The third-party file has ended. Everything between the 271972dff2022eaf tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© HKUDS · Apache-2.0 · https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-pm2/SKILL.md

## Similar
- [cyrus-setup-launch](https://affpapa.org/en/nevibecode/skills/cyrus-setup-launch.md) — skill · 997 installs
- [dockerfile-optimizer](https://affpapa.org/en/nevibecode/skills/dockerfile-optimizer.md) — skill · 530 installs
- [reflex-process-management](https://affpapa.org/en/nevibecode/skills/reflex-process-management.md) — skill · 679 installs
- [ci-cd-and-automation](https://affpapa.org/en/nevibecode/skills/ci-cd-and-automation.md) — skill · 58100 installs
- [convex-deploy-guard](https://affpapa.org/en/nevibecode/skills/convex-deploy-guard.md) — skill · 36000 installs
- [adding-docker](https://affpapa.org/en/nevibecode/skills/adding-docker.md) — skill · 398 installs

From the same set: [hkuds/cli-anything](https://affpapa.org/en/nevibecode/by/hkuds/cli-anything.md) — 55 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md