rtk-ai/rtk

feat: Add pm2 command support (list, logs, restart)

Open

#1525 opened on Apr 25, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Rust (48,085 stars) (2,914 forks)batch import
effort-mediumenhancementgood first issue

Description

pm2 is widely used for process management in Node.js projects. Its output is heavy on ANSI formatting and table borders, making it a good candidate for RTK filtering.

Commands and output characteristics:

  • pm2 list — wide ANSI table with box-drawing characters, status colors. ~30-50 lines per run.
  • pm2 logs <name> --lines N — log output with ANSI timestamps. Already bounded by --lines but ANSI stripping alone would save tokens.
  • pm2 restart <name> — short output (1-3 lines), lower priority.

None of these are intercepted by the hook engine:

$ rtk hook check "pm2 list"        # → exit 1, no rewrite ✗
$ rtk hook check "pm2 logs app"    # → exit 1, no rewrite ✗
$ rtk hook check "pm2 restart app" # → exit 1, no rewrite ✗

Suggested behavior:

  • pm2 list → strip ANSI, compact table format, show name/status/cpu/mem columns only
  • pm2 logs → strip ANSI color codes, preserve timestamps and content
  • pm2 restart → passthrough (already compact)

Usage context: ~639 calls/month across Claude Code sessions (316 logs, 211 restart, 112 list).

Contributor guide

Tech stack
rustnodejs
Domain
clideveloper experience
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic Rust knowledgeUnderstanding of rtk's hook engineFamiliarity with pm2 output
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70
Research direction
Investigate how rtk currently handles other command filters (e.g., for grep, ls) by examining the existing hook implementations in the codebase. Focus on the hook registration and ANSI stripping logic. The issue provides specific commands and desired output transformations, so the implementation should add new patterns for pm2 list, logs, and restart in the command routing module.