Repository navigation
Releases
Releases · RajParmar2003/port-manager
v0.1.0 - feature complete
First tagged release. Native macOS desktop app for scanning, grouping, and killing open TCP/UDP ports.
Highlights
- Live port scanning every five seconds via
lsof - Group by git project — each process tagged with the repo it came from
- Next-free-port suggester — type a base port, get the next unused one copied to clipboard
- Kill flows for single rows, whole projects, categories, and multi-selected ports — SIGTERM by default, SIGKILL on opt-in
- Supervision-aware —
launchd-managed processes getlaunchctl stopinstead of raw kill - Docker context — container-backed ports surface name, image, status
- Orphan detection — flags processes with no parent, no TTY, no supervisor
- Port history persists across launches at
~/Library/Application Support/port-manager/history.json - macOS menubar tray and native conflict notifications
- Dark / light theme with persisted preference
Install
This release does not include pre-built binaries. Build from source:
git clone https://github.com/RajParmar2003/port-manager.git
cd port-manager
cargo tauri buildThe .app and .dmg land in src-tauri/target/release/bundle/. The build is unsigned — first launch needs a right-click → Open to bypass Gatekeeper.
Documentation
- README — pitch, features, install
- Architecture — design rationale for the six major decisions
- CHANGELOG — full feature inventory
- v0.2 roadmap — project manifest reading (next feature)
Known limitations
- macOS only
- LISTEN state only (no ESTABLISHED / TIME_WAIT)
- Unsigned binary
- Local-only (no remote or cloud port visibility)
- Observation only (does not launch processes)