macOS menu bar · native · free

Every dev server you left running. One click to stop it.

Porter lives in the menu bar and lists every local dev server on your Mac: the project it belongs to, its git branch, its port and how long it has been up. Open it in the browser, show the project in Finder, or stop it, without looking up a PID in Terminal.

Free · macOS 13 Ventura or later

// menu bar popover
Scans with
lsof · libproc
Background daemon
None
Telemetry
None
Requires
macOS 13+
01Features

What is running, and where. Without opening Terminal.

One row per server, and the three things you would do with it. Nothing else lives in the popover.

02How it works

One lsof call every three seconds. No daemon, no helper, no network.

Porter scans while the popover is open, and reads only processes your user account owns. The whole pipeline is three steps.

  1. 01

    List what is listening

    One lsof call returns every TCP socket in the LISTEN state, with its process ID, full command name and address. It is the only subprocess Porter runs.

    // one subprocess per scan
    lsof +c 0 -iTCP -sTCP:LISTEN
         -n -P -F pcn
    → pid · command · host:port
  2. 02

    Read each process

    The working directory, the real executable path, the owner and the start time come from libproc and sysctl. The branch comes from .git/HEAD.

    // system calls, not more lsof
    proc_pidinfo → cwd · owner
    proc_pidpath → executable
    sysctl       → start time
    .git/HEAD    → branch
  3. 03

    Keep the dev servers

    Four rules, in order. The first is a fact; the other three are a filter you can switch off in Settings.

    1. 1Yours Owned by your user account. Root and other users’ processes are never listed.
    2. 2Local Bound to loopback or the wildcard address, not one LAN or tunnel interface.
    3. 3Known A runtime or database, matched on the executable’s exact name.
    4. 4Otherwise A port in 3000–9999 held by something that is not inside a .app bundle.
03Stopping safely

Stop means SIGTERM first. SIGKILL only if needed.

Stopping a process is the one destructive thing Porter does, so every step is checked and every failure is reported.

// 1 · ask the server to shut down
killpg(pgid, SIGTERM)  // the group, if it leads one
kill(pid, SIGTERM)     // otherwise the process alone

// 2 · wait no longer than it needs
poll every 50 ms, for up to 2 s

// 3 · still the process that was scanned?
start time == start time at scan

// 4 · only then
killpg(pgid, SIGKILL)
poll every 50 ms, for up to 2 s

// anything else is reported on the row
EPERM · ESRCH · PID reused · still running
// what one click on Stop does, from ProcessTermination.swift
  1. It asks first

    The trash icon only arms the row. Nothing is signalled until you click Stop.

  2. SIGTERM, then a short grace period

    Dev servers have shutdown hooks worth waiting for: flushing a cache, closing a database handle. Porter waits up to two seconds and moves on the moment the process exits.

  3. The children go with it

    When the server leads its own process group, as npm run dev does, the whole group is signalled, so an esbuild helper does not keep the port bound.

  4. Nothing else is touched

    A server sitting in a group it does not lead, such as one started in an editor’s terminal, is signalled on its own. Porter never signals its own group, and never one that is not yours.

  5. A recycled PID is caught

    The start time seen at scan time is checked again before SIGKILL. If the PID now belongs to a different process, nothing is stopped.

  6. Failures are shown, not swallowed

    Not permitted, already exited, PID reused, still running after SIGKILL: each one is reported on the row.

04What it finds

Dev servers, not every app with a port. With a switch for when it guesses wrong.

The exact executable names Porter recognises, from PortClassifier.swift. Anything else you own on a port in 3000–9999 is listed too, unless it lives inside an installed app.

Group Executable names Shown
JavaScript Vite, Next.js, Nuxt, Astro, Remix and anything run through npm, pnpm, yarn or bun
  • node
  • deno
  • bun
  • npm
  • npx
  • yarn
  • pnpm
  • vite
  • next
  • nuxt
  • astro
  • remix
  • gatsby
  • webpack
  • esbuild
  • parcel
  • turbo
  • nodemon
  • serve
  • http-server
By default
Python Version suffixes are ignored, so python3.12 counts
  • python
  • flask
  • django
  • gunicorn
  • uvicorn
  • hypercorn
  • daphne
By default
Ruby rails s, bundle exec, and the app servers behind them
  • ruby
  • bundle
  • rails
  • puma
  • unicorn
  • thin
By default
Other runtimes PHP, the JVM, .NET, Erlang and Elixir, Rust, Go, static site generators
  • php
  • java
  • gradle
  • sbt
  • dotnet
  • erl
  • beam
  • mix
  • cargo
  • air
  • hugo
  • jekyll
By default
Platform CLIs Local dev servers from hosting providers
  • wrangler
  • vercel
  • netlify
  • firebase
By default
Databases and caches Listed even inside an app bundle, because that is how Postgres.app ships
  • postgres
  • postmaster
  • mysqld
  • mariadbd
  • redis-server
  • valkey-server
  • mongod
  • memcached
  • elasticsearch
  • opensearch
  • clickhouse
  • minio
  • rabbitmq-server
  • nats-server
  • etcd
  • consul
  • meilisearch
  • typesense
By default
Anything else on a dev port A compiled Go or Rust server, a static file server: yours, on localhost, not part of an installed app
  • any port in 3000–9999
By default
Everything else you own Docker and OrbStack forwards, GUI apps, sockets bound to one interface
  • any listening port
With setting on
05Screenshots

Small, quiet, out of the way. In the menu bar, not the Dock.

// Popover · follows the system appearance

Download · v1.17

Find the server on :3000.

Free, native, and in your menu bar in a minute. No account, no configuration.

Free · macOS 13 Ventura or later

Updates arrive through Sparkle inside the app, each one signature-checked before it installs. Requires macOS 13 Ventura or later. Developer ID signed and notarized by Apple.