Brijraj Rana

Portpeek

Vibe coded Mac app, 2026

See what is listening on your ports, from a corner of the screen.

View on GitHub Download

Portpeek open in the top right corner: a black panel listing ports under the project my-shop, then others, each with its process, where it was started from, and a Kill button
The open panel

Details

Role
Design and direction, vibe coded
Built with
Swift, SwiftUI, AppKit
Platform
macOS 14+, Apple Silicon and Intel
Year
2026
Source
Open, MIT, v0.3.0

What it does

Address already in use, then a search for the lsof incantation, a PID, a kill. Portpeek is that without the terminal: push the pointer into a corner of the screen and every listening port is there, with the process and project behind it and a button to stop it.

Design notes

  1. A corner is the largest target on a screen

    The pointer cannot overshoot it, so there is nothing to aim at. Any of the four corners can be the one.

  2. Nothing until asked

    No menu bar icon, no Dock icon, no window. The panel grows out of its corner and shrinks back into it, and it only scans while it is open.

  3. Whose port it is

    Each row names the folder the process was started in and the app it was started from. Click the app to go back to it.

  4. A project is one thing

    A dev server and its API share a folder, so they share a heading and one Stop all.

  5. Polite first

    Kill asks the process to quit so it can clean up. Force is offered only after that has failed.

  6. Noise stays out

    AirPlay, Handoff and app helpers on random ports are tucked behind one line at the bottom.

  7. The rest, one click in

    A row opens to the full command line, how long it has run and its memory, with the command to start it again.

  8. Containers by name

    A Docker port shows the container that published it, and Stop stops that container, never Docker itself.

  9. Also a command

    portpeek lists ports, portpeek kill 3000 frees one, for the times the hands are already in a terminal.

  10. Color means something

    Green is listening. Red is the destructive button, and only under the pointer.

More screens

Portpeek with the row for port 3000 open, showing its command line, up 3 hours, 412 MB, and Copy for the command, the address and a restart command
A row opened: the command, how long, how much memory
Portpeek listing Docker ports by container name, shop-db on postgres 17 and shop-cache on redis, each with a Stop button
Docker ports under their container names
Portpeek with ports 3000 and 3001 grouped under the project my-shop with a Stop all button, each started from Cursor, and port 5173 started from Terminal
Two ports of one project, with where each was started
Portpeek with three ports listed; the Kill button on port 5173 has become a red Force button
Kill becomes Force when a process ignores the first request

Source

Portpeek is open source under the MIT licence. The code is on GitHub.