procman

Process manager CLI. Monitor, restart, manage background processes.

Install

npm install -g procman

Usage

# Start a process
procman start "node server.js" --name myapp
procman start "python app.py" -n webapp

# List running processes
procman list
procman ls

# Stop a process
procman stop myapp
procman stop all

# Restart a process
procman restart myapp

# Show process info
procman info myapp

# Show logs
procman logs myapp
procman logs myapp --lines 50

# Kill by port
procman kill-port 3000

# Help
procman --help

Output

$ procman start "node server.js" -n api
  ✓ Started 'api' (PID: 12345)

$ procman list
  NAME        STATUS    PID       UPTIME      CPU     MEM
  ------------------------------------------------------------
  api         running   12345     2h 15m      0.5%    2.1%
  worker      running   12346     1h 30m      2.1%    3.5%

$ procman info api
  Name:     api
  Status:   running
  PID:      12345
  Command:  node server.js
  Started:  2024-01-01T10:00:00Z
  Uptime:   2h 15m
  CPU:      0.5%
  Memory:   2.1%

$ procman stop api
  ✓ Stopped 'api' (was PID: 12345)

Storage

Process data stored in ~/.procman/:

• processes.json - Process registry
• logs/ - stdout/stderr logs

License

MIT

rtfm.codes - read the fine manual