← sources

My friend gave me an idea to turn my Mac's open ports into a living harbour town. Claude Opus coded it faster than I could blink, and it’s honestly mesmerizing. Releasing soon!

source: reddit (reddit:ClaudeCode)published 2026-09-23 09:57ingested 2026-09-24 02:40

retained text

My friend using portlist for a while and gave me an idea :

>*"Why do we stare at boring CLI tables like* `lsof` *and* `netstat` *all day? Your computer is basically an industrial harbour* *ports are docks, services are factories, Docker containers are shipping crates, and AI agents are workers running around."*

we couldn't get the visual out of my head, so we fed the whole concept and state engine prompt into Claude Opus.

What came out blew my mind.

Instead of another boring terminal dashboard wrapper, we are integrating **Portlist Harbour** directly into our TUI (accessible via the `W` key): an interactive, living isometric world rendered straight to an HTML canvas:  


* **Real state, zero guessing:** If a factory building lights up or chimney smoke billows, there is an actual listening socket behind it. If it goes idle, dust and cobwebs start gathering.
* **"AI Agent left the lights on":** When Claude Code or Cursor opens a dev server and exits the terminal session, the little robot worker drops its tools, walks out of the East Gate, and a harbour cat walks over with a clipboard to investigate why the factory is still burning electricity.
* **Port Conflicts (**`EADDRINUSE`**):** If two processes fight for `:3000`, two trucks literally lock bumpers at the dock with sparks flying until you click to terminate the contender.
* **Real LAN exposure:** The moment a service binds to [`0.0.0.0`](http://0.0.0.0), the boom barrier on the toll gate lifts, sirens flash red, and guard cats go on high alert.
* **Docker & Feeder Ships:** OrbStack/Docker containers arrive via feeder ships offshore and get unloaded by an STS crane into the yard.

You can click any factory, worker, container, or cat to see exact PIDs, uptimes, provenance trees, and a 1-click `kill -9` button.

I'm finishing up some edge cases (multi-lane parking throughput, terminal keyhooks) and will be releasing the repo/build very soon.

Check out the project here: [https://github.com/Mr-hunt-007/portlist](https://github.com/Mr-hunt-007/portlist?utm_source=gemini)

Would love to know: what's one funny or weird system event you'd want to see visualised as a physical dock incident?

https://preview.redd.it/ufkgrk6ys8rh1.png?width=2926&format=png&auto=webp&s=f1fdc9ab8e6a6ae5f7043ef6d5516f677855b560

document fetched 2026-09-24 00:43 · canonical https://reddit.com/r/ClaudeCode/comments/1wo1mus/my_friend_gave_me_an_idea_to_turn_my_macs_open