Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PortMap

A lightweight macOS utility that shows what's listening on your dev ports — and lets you act on it instantly.

PortMap

Features

  • Live port list — polls TCP listeners in a configurable range (default 3000–9999) every 1.5 s
  • Project inference — resolves each process's working directory and walks up to find the nearest package.json, Cargo.toml, or pyproject.toml to show the project name
  • Copy URL — copies http://localhost:PORT to clipboard
  • Copy Path — copies the project directory as a shell-escaped path, ready to cd into
  • Kill — sends SIGTERM to the process
  • Configurable refresh — Fast (500 ms), Medium (1.5 s), Slow (5 s), or Custom
  • Zoom — Cmd+= / Cmd+- / Cmd+0, persisted across launches
  • Window size — remembered across launches

Stack

Development

bun install
bun run tauri dev

Build

# Full build (includes .app + .dmg installer)
bun run tauri build

# .app only — skips DMG creation
bun run tauri build --bundles app

Output: src-tauri/target/release/bundle/macos/PortMap.app

Drag into /Applications. On first launch, right-click → Open to bypass Gatekeeper (app is unsigned).

Note: DMG creation requires Automation permission granted to your terminal in System Settings → Privacy & Security → Automation → Finder.

Attribution

Built with Claude Sonnet 4.6 and Claude Code.

About

macOS dev tool that shows listening ports with process and project info — kill, copy URLs, or cd into them instantly

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages