A fresh mix of everything
on your ports

The macOS menu bar app that maps your ports to projects, sniffs out conflicts, and keeps your dev environment tidy.

v0.3.0 — Now with dark mode & AI tool tracking
Portpourri 3 running Just now
api nest start · node 3000 ❯
~/myapp/apps/api
nest start
node dist/main.js
web next dev · storybook 3001 6006 ❯
~/myapp/apps/web
next dev --turbopack
storybook dev -p 6006
mobile worktree expo start 8081 ❯
~/myapp/.claude/worktrees/feature-auth/apps/mobile
expo start
Node processes 28 · 1.0 GB ❯
12× node 420 MB ❯
4× next dev 310 MB ❯
6× npm 145 MB ❯
3× nest start 92 MB ❯
3× expo start 88 MB ❯
✱ Claude Code 3 worktrees · 8 sessions 587 MB ❯
feature-auth myapp 280 MB
fix-ci myapp 5d 245 MB
rewrite docs-site 8d 62 MB
⚙ Codex 5 worktrees · 42 sessions 2.5 GB ❯
a1b2 890 MB
c3d4 4d 720 MB
e5f6 7d 410 MB
4 stale (3+ days)

Get started

macOS 14+ required

Download for Mac View on GitHub
or

Homebrew

terminal
$ brew tap jskoiz/nodewatcher $ brew install --cask nodewatcher

Build from source

terminal
$ git clone https://github.com/jskoiz/node-watcher.git $ cd node-watcher && ./Scripts/package_app.sh
What's in the mix

Six ingredients for a cleaner dev setup

Everything you need to understand your local dev environment at a glance.

Project-aware

Maps processes to project roots. See "api on :3000" instead of cryptic PIDs.

Conflict detection

Instantly know when your port is blocked by Docker, SSH, or another process.

AI tool tracking

Claude Code and Codex worktree counts, disk usage, and stale cleanup alerts.

Dark mode

Follows your system appearance automatically. Native on light and dark desktops.

Global hotkey

Toggle from anywhere with Ctrl+Shift+P. No need to hunt for the icon.

CLI included

Script it with nodetracker snapshot --json for CI or custom tooling.

Freshly picked

The latest from the garden

What's new in recent releases.

0.2.9
Mar 27

Dark Mode & Polish

  • newPopover follows system appearance automatically
  • improveConsistent text sizing across all rows
  • improveUnified chevron size and AI tool icon alignment
0.2.8
Mar 26

Dot Matrix & Brand Icons

  • newDot matrix menu bar mode with color-coded memory gauge
  • newClaude Code and Codex brand logos in AI tools section
  • improveFully synthetic sample data for clean screenshots
0.2.7
Mar 25

AI Tools Section

  • newWorktree tracking for Claude Code and Codex
  • newDisk usage per worktree, sizes >1 GB highlighted red
  • fixPopover dismiss animation snap
  • fixIdle state view when no Node processes running
0.2.6
Mar 24

Visual Polish

  • improveLighter popover with improved material vibrancy
  • newExpandable process groups with Kill all + Copy PIDs
  • fixControlCenter filtered from port conflicts