pscout

See what's running on your ports.

Developers running multiple local servers have no clean way to see what's listening, on which port, and whether it's intentional or orphaned. lsof and netstat output is unreadable. pscout fixes that.

Install

npm install -g pscout

Usage

pscout              # one-shot table view
pscout watch        # live refresh every 2s
pscout kill <port>  # kill process on a port (with confirmation)
pscout --all        # include system ports in output
pscout --simple     # ASCII borders (auto-enabled in tmux)
pscout --unicode    # force unicode (override tmux detection)

Output

  ╭────────────────────────────────────────────────────────────╮
  │  pscout  ·  10 ports  ·  11:42:03 AM                    │
  ╰────────────────────────────────────────────────────────────╯

  DEV SERVERS
  ●  :3100   node      PID 15710   2h 14m   next dev · ~/projects/foo
  ●  :3200   node      PID 71202   0h 08m   vite · ~/projects/bar
  ●  :8080   node      PID 35041   4h 01m   node server.js · ~/projects/baz
  ●  :3335   Python    PID 62684   1h 22m   uvicorn main:app · ~/projects/api

  INFRASTRUCTURE
  ◆  :6379   Redis     PID 784     8h 30m
  ◆  :5432   Postgres  PID 796     8h 30m
  ◆  :11434  Ollama    PID 1782    5h 10m

  7 system ports hidden · run --all to show

Kill flow

$ pscout kill 8082

  Kill process on :8082?
  node · PID 18242 · running 3h 55m · node server.js · ~/projects/baz

  [y/N] y
  sending SIGTERM to PID 18242...
  killed.

Sends SIGTERM first. If the process doesn't exit within 1 second, follows up with SIGKILL.

Categorization

| Category | Rule | |---|---| | Dev server | node or Python process on port > 1024, not known infra | | Infrastructure | redis-server, postgres, mysql, mongod, ollama | | System | Everything else (hidden by default) |

Flags

| Flag | Description | |---|---| | --all | Show system ports | | --simple | ASCII borders (auto in tmux) | | --unicode | Force unicode borders | | --help | Show help | | --version | Show version |

Requirements

• macOS (uses lsof)
• Node.js >= 18

License

MIT