Zurück zu den Projekten
Bald verfügbar

PortPirate

Lokale Dev-Server auf deinem Mac, gestartet von dir und deinen Coding-Agents, ohne Port-Kollisionen.

Eine macOS-Menüleisten-App für alle, die mit Claude Code oder Codex arbeiten. Sie zeigt jeden lokalen Dev-Server, welche Agent-Session ihn in welchem Worktree gestartet hat und was diese Session gerade tut. Agents bekommen eigene Werkzeuge: Ein Aufruf startet einen Dev-Server auf einem freien Port und liefert die URL zurück. Danach lesen sie seine Logs, finden die lokale Datenbank und stoppen nur, was ihnen gehört. Du siehst alles in einem Panel.

Noch nicht veröffentlicht. Der Build ist derzeit privat.

Plattform
macOS
Verfügbarkeit
bald verfügbar
Stack
Swift · SwiftUI · MCP
PortPirate menu bar panel with four Claude Code sessions and two dev servers an agent started through PortPirate

Problem

Arbeiten mehrere Coding-Agents parallel in Worktrees, stapeln sich die Dev-Server, zwei Agents greifen nach Port 3000, und niemand weiß, welcher Prozess zu welcher Session gehört. Die Agents behelfen sich mit sleep-Schleifen, curl-Polling und kill -9.

Was ich gebaut habe

Eine native Swift-Menüleisten-App, die jeden lauschenden TCP-Port seinem Prozess, Repo, Branch und seiner Agent-Session zuordnet, mit Hooks für den Live-Status der Sessions. Ein mitgelieferter MCP-Server und der Befehl pp geben Agents elf Werkzeuge. start_server reserviert pro Worktree einen Portblock, erkennt Paketmanager und Framework, startet den Server, wartet, bis er antwortet, und schreibt seine Ausgabe in ein Log. wait_for_port, server_logs, list_services und project_context decken den Rest ab. Jeder Stopp läuft über einen einzigen geprüften Pfad in der App.

Highlights

  • Jede Claude-Code- und Codex-Session nach Projekt und Branch, mit Live-Status: arbeitet, wartet auf dich, braucht Freigabe.
  • Agents starten Dev-Server mit einem MCP-Aufruf: freier Port pro Worktree, passender Paketmanager, --port für Vite, Astro, Next.js und Nuxt, zurück kommen URL und Log.
  • Lokale Datenbanken und Dienste wie PostgreSQL, Redis oder MongoDB erscheinen mit ihrer Verbindungs-URL, für dich und für Agents.
  • pp im Terminal: pp start, pp logs -f, pp who 3000, pp stop, eval "$(pp env)". pp setup richtet Hooks, MCP und einen kurzen Abschnitt in CLAUDE.md und AGENTS.md ein.
  • Derselbe MCP-Server funktioniert auch in Cursor, Windsurf, VS Code, Zed und Claude Desktop.
  • Agents stoppen nur eigene Server. PID, Port, Befehl und Ordner werden vor jedem Signal neu geprüft, und in den Einstellungen legst du fest, was Agents dürfen.