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
- Scans with
- lsof · libproc
- Background daemon
- None
- Telemetry
- None
- Requires
- macOS 13+
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.
-
Every server in one list
Project name over branch, port and uptime. The project is the folder the server runs in, so four node processes read as storefront, api, docs and admin.
-
Git branch, worktrees included
Read from .git/HEAD, walking up from the working directory, so a server started in packages/web still shows its branch. Worktrees and submodules resolve; a detached HEAD shows its short commit.
-
Open or reveal
The arrow opens localhost on that port in your default browser. Right-click a row to show the project folder in Finder.
-
Stop a server
Click the trash icon, then Stop. Porter sends SIGTERM, waits up to two seconds, and sends SIGKILL only if the process is still there. A failure is shown on the row.
-
Search
Filters by project, port, command or branch as you type. “auth” finds the server on feature/auth, whatever its folder is called.
-
Native and small
Swift and SwiftUI. No Dock icon, no Electron, no background daemon, no account, no telemetry. Launches at login if you want it to and updates itself through Sparkle.
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.
- 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 - 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 - 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.
- 1Yours Owned by your user account. Root and other users’ processes are never listed.
- 2Local Bound to loopback or the wildcard address, not one LAN or tunnel interface.
- 3Known A runtime or database, matched on the executable’s exact name.
- 4Otherwise A port in 3000–9999 held by something that is not inside a .app bundle.
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 -
It asks first
The trash icon only arms the row. Nothing is signalled until you click Stop.
-
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.
-
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.
-
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.
-
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.
-
Failures are shown, not swallowed
Not permitted, already exited, PID reused, still running after SIGKILL: each one is reported on the row.
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 |
| By default |
| Python Version suffixes are ignored, so python3.12 counts |
| By default |
| Ruby rails s, bundle exec, and the app servers behind them |
| By default |
| Other runtimes PHP, the JVM, .NET, Erlang and Elixir, Rust, Go, static site generators |
| By default |
| Platform CLIs Local dev servers from hosting providers |
| By default |
| Databases and caches Listed even inside an app bundle, because that is how Postgres.app ships |
| 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 |
| By default |
| Everything else you own Docker and OrbStack forwards, GUI apps, sockets bound to one interface |
| With setting on |
Small, quiet, out of the way. In the menu bar, not the Dock.
Download · v1.17
Find the server on :3000.
Free, native, and in your menu bar in a minute. No account, no configuration.
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.