portdeck.app

Your AI-native local runtime dashboard.

See every local server, Docker container, port, and worktree from one Mac menu bar.

PortDeck File Edit View 9:41 AM

The problem

Local development used to be one developer, one branch, one server. Now it is one developer, multiple AI agents, multiple worktrees, Docker containers, Convex, Vercel previews, and a bunch of local ports.

PortDeck is the control tower for that chaos.

What PortDeck shows

Localhost servers and listening ports
PID, process name, command, and cwd when available
Git repo root, branch, and worktree
Docker containers with published ports
Project → worktree → service grouping
Open, copy, reveal, kill, and refresh actions

Why AI-native builders need this

AI agents make it cheap to spin up parallel work. They also make it easy to lose track of which terminal, worktree, container, and port belongs to the thing you are testing.

PortDeck keeps the local runtime map visible before stale processes turn into guesswork.

Free/open-source local tool

The local dashboard stays free and open source: port discovery, Docker discovery, worktree grouping, quick actions, labels, and the CLI.

No auth. No payments. No cloud sync. No telemetry required.

Future Pro features

Vercel deployment status
Convex status
GitHub Actions status
Cloudflare status
Local vs deployed health
Notifications
Project profiles
Team/shared environments later

Public roadmap

V0.1

Detect listening localhost ports.
Identify PID, process name, command, and cwd when possible.
Infer Git repo root, branch, and worktree from cwd.
Detect Docker containers with published ports.
Group services by project → worktree → service.
Add actions: open URL, copy URL, reveal folder, kill process, refresh.
Provide portdeck status --json.

V0.2

Better worktree awareness.
Persistent local service labels.
Project grouping and naming.
Basic config in ~/.portdeck.

V0.3

portdeck run.
Agent/session awareness for Codex, Claude, and Cursor.
Register services intentionally instead of only discovering them.

V0.4

Stable local names.
Optional local proxy.
Portless-inspired routing, but not dependent on Portless.

Future Pro

Vercel, Convex, GitHub Actions, Cloudflare, local vs deployed health, notifications, project profiles, and team/shared environments later.