Unitech / Unitech/pm2

Add the ability to force the wide display of `list`

Open
#6,095 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
43.3k
Forks
2.7k
PR merge metrics
No merged PRs in 30d

Description

When you have a narrow window pm2 list hides some important information. This 'feature' is not documented in pm2 list --help and there’s no option to force-show this information but to fake your environment to make pm2 think it’s wider.

There should be 1- documentation about this unexpected behavior and 2- a way to bypass it.

--- PM2 report ----------------------------------------------------------------
Date                 : Thu Mar 19 2026 10:09:27 GMT+0000 (Coordinated Universal Time)
===============================================================================
--- Daemon -------------------------------------------------
pm2d version         : 6.0.13
node version         : 20.20.1
node path            : not found
argv                 : /usr/bin/node,/usr/lib/node_modules/pm2/lib/Daemon.js
argv0                : /usr/bin/node
user                 : redacted
uid                  : 0
gid                  : 0
uptime               : 14360min
===============================================================================
--- CLI ----------------------------------------------------
local pm2            : 6.0.13
node version         : 20.20.1
node path            : not found
argv                 : /usr/bin/node,/usr/bin/pm2,report
argv0                : node
user                 : redacted
uid                  : 0
gid                  : 0
===============================================================================
--- System info --------------------------------------------
(irrelevant)
===============================================================================
--- PM2 list -----------------------------------------------
┌────┬────────────────────┬──────────┬──────┬───────────┬──────────┬──────────┐
│ id │ name               │ mode     │ ↺    │ status    │ cpu      │ memory   │
├────┼────────────────────┼──────────┼──────┼───────────┼──────────┼──────────┤
│ 0  │ redacted           │ fork     │ 21   │ online    │ 18.3%    │ 265.8mb  │
└────┴────────────────────┴──────────┴──────┴───────────┴──────────┴──────────┘
===============================================================================
--- Daemon logs --------------------------------------------
/root/.pm2/pm2.log last 20 lines:
(irrelevant)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the narrow-window behavior with pm2 list and compare it with pm2 list --help; then trace the CLI handling for the list command. Done means documenting the current behavior and providing a supported option to force the hidden information to display.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, nodejs
Domain
cli, documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.