productdevbook/port-killer
62.5
Adequate · 14 November 2026
21.2k
lines of production code
Swift
with C#, Python, Rust
5
measurements over time
What this system is
PortKiller is a cross-platform desktop utility for monitoring and managing local network ports, supporting macOS, Windows, and Linux. It provides native clients that integrate with system trays to scan for listening TCP ports, terminate associated processes, and manage Cloudflare tunnels and Kubernetes port forwards. The application allows users to organize ports with labels and notes, set auto-kill rules, and receive notifications, replacing its previous legacy menu-bar architecture with dedicated, feature-rich interfaces for each operating system.
Features
Introduce native Linux tray application with system integration
PortKiller now offers a native Linux experience via a Python-based tray app, replacing previous methods. The application integrates with the desktop environment by installing an autostart entry, a desktop launcher, and a system tray icon (using AppIndicator/Ayatana). It provides a GTK3-based interface for monitoring local ports, managing Cloudflare tunnels, and controlling Kubernetes port-forwards, featuring a searchable floating window and a system tray menu for quick actions like killing processes or copying URLs. The installation script handles dependency checks for Python 3, GTK3, and AppIndicator libraries, and copies the application assets to the user's local share directory.
platforms/linux, portkiller-core · high confidence
Introduce native Windows WPF client for PortKiller
A new native Windows desktop application has been added to the Windows platform, built with WPF and featuring a modern dark UI with acrylic blur effects. This client provides a system tray icon for quick access, a main window for scanning and killing ports, and a dedicated Cloudflare Tunnels management view that allows users to select protocols and manage tunnel states. The application includes a mini-window for compact monitoring and uses dependency injection to manage services for port scanning, process killing, settings, and notifications.
platforms/windows · high confidence
PortKiller macOS app introduces auto-refresh, port labels, notes, favorites, and auto-kill rules
The macOS application now features an adaptive auto-refresh mechanism that dynamically adjusts polling intervals based on port list stability, reducing resource usage when ports are idle. Users can now organize their port list with custom labels and freeform notes for each port, mark ports as favorites, and set up auto-kill rules to automatically terminate processes that have been listening for a specified duration. The app also supports process type notifications, allowing users to receive alerts when new ports matching specific process types appear, and includes a deep kill option to terminate both the listening process and its established connections.
platforms/macos/Sources · high confidence
Removals
Removal of PortManager and PortScanner modules
The PortManager and PortScanner classes have been removed from the application. This eliminates the previous functionality that scanned for listening TCP ports using the system lsof command and managed the lifecycle of port-scanning tasks, including auto-refresh intervals and process termination (kill) operations.
Sources/Managers · high confidence
Removal of legacy build-app.sh script
The \scripts/build-app.sh\ file, which previously handled building the release binary and assembling the application bundle, has been removed. This change eliminates the manual steps for copying resources, signing the app, and creating the final \.app\ directory structure, indicating a shift to a different build or packaging mechanism.
scripts · high confidence
Removal of legacy menu bar interface and port model
The application has removed the previous \MenuBarView\ (the standalone menu bar UI with search, port list, and kill actions) and the \PortInfo\ model struct. This change eliminates the old single-window menu bar experience in favor of the new main window architecture introduced in this release.
Sources/Views · high confidence
Behavioural changes
Per-port customizations and Kubernetes context selection
Users can now customize individual port entries with a custom display name, description, project folder, and process type override, replacing the previous separate label and note fields (which are migrated automatically). The right inspector pane is now collapsible, and the port list filter includes these new customization fields in its search. For Kubernetes port forwards, users can select a specific cluster context and provide a custom kubeconfig file per connection, with the underlying kubectl commands updated to respect these targets. Also in this area: Added tests for Cloudflare tunnel discovery and port filtering logic.
platforms/macos/Tests · high confidence
Removal of legacy menu bar app entry point
The legacy \PortKillerApp\ entry point, which previously launched the application as a menu bar extra with a fixed system icon and no main window, has been removed. This change eliminates the old single-scene architecture in favor of the new structure that includes a main window and enhanced port management features.
Sources · high confidence
macOS app icon updated with transparent margin and version bumped to 1.2.1
The macOS app icon has been redesigned to include a standard 100px transparent margin, ensuring it renders at the correct size in the Dock and Finder rather than appearing oversized. The application version has been updated to 1.2.1 (build 13), and the Info.plist now includes configuration for Sparkle automatic updates, high-resolution support, and user notifications.
platforms/macos/Resources · high confidence
macOS build script patches KeyboardShortcuts for app bundle compatibility
The macOS build script now automatically patches the KeyboardShortcuts library source files during the build process to ensure resource bundles are located correctly within the macOS app bundle structure. This change modifies the library's localization and resource access logic at build time, allowing the PortKiller.app to function correctly without requiring manual intervention or external configuration for resource paths.
platforms/macos/scripts · high confidence
Dependencies
Initial dependency manifests for multi-platform release automation and native clients
This change introduces the foundational dependency manifests for the PortKiller project, establishing the tooling and libraries for its new multi-platform architecture. It adds a root package.json defining bumpp for release automation, a macOS Package.swift targeting Swift 6.2 and macOS 15 with dependencies on KeyboardShortcuts, Defaults, LaunchAtLogin-Modern, and Sparkle for native macOS features, a Windows PortKiller.csproj targeting .NET 9.0 with WPF and CommunityToolkit.Mvvm, and a Rust core library (portkiller-core) using Tokio and serde. These manifests replace the previous single root Package.swift, signaling a shift from a monolithic Swift structure to distinct, platform-specific implementations.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 56 → 63 (+6.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 53 → 69 (+16.6)
- Architecture 80 → 76 (-4.2)
- Maturity 58 → 69 (+10.6)
- Readiness 57 → 60 (+3.5)
- Security 67 → 67 (-0.2)
- Performance 60 → 60 (+0.0)
Resolved (12)
- Coverage not measured — no coverage collector is wired up
- Duplicated block (11 lines × 2) (platforms/macos/Sources/Views/CloudflareTunnels/CloudflareTunnelsView.swift)
- Duplicated block (12 lines × 2) (platforms/macos/Sources/Views/Settings/AutoKillSettingsSection.swift)
- Duplicated block (12–13 lines × 3) (platforms/macos/Sources/Views/Settings/CloudflaredSettingsSection.swift)
- Duplicated block (18 lines × 2) (platforms/macos/Sources/Views/SponsorsWindowView.swift)
- Duplicated block (6 lines × 2) (portkiller-core/src/scanner/linux.rs)
- Edited copy of a member (9 corresponding lines) (platforms/windows/PortKiller/MainWindow.xaml.cs)
- End-of-life runtime: .NET net9.0 (platforms/windows/PortKiller/PortKiller.csproj)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (platforms/macos/Sources/Services/PortGroupingService.swift)
- No ADRs found
New (36)
- Duplicated block (11 lines × 2) (platforms/macos/Sources/Views/CloudflareTunnels/CloudflareTunnelsView.swift)
- Duplicated block (18 lines × 2) (platforms/macos/Sources/Views/SponsorsWindowView.swift)
- Duplicated block (8 lines × 2) (portkiller-core/src/scanner/linux.rs)
- Edited copies of one member (3 members, 20+ corresponding lines) (platforms/windows/PortKiller/MiniPortKillerWindow.xaml.cs)
- Edited copies of one member (3 members, 6+ corresponding lines) (platforms/macos/Sources/Services/DependencyChecker.swift)
- Edited copy of a member (10 corresponding lines) (platforms/macos/Sources/Views/MenuBar/MenuBarPortForwardRow.swift)
- Edited copy of a member (12 corresponding lines) (platforms/macos/Sources/Services/PermissionService.swift)
- Edited copy of a member (12 corresponding lines) (platforms/macos/Sources/Views/PortForwarder/DetailPanel/KubeContextPicker.swift)
- Edited copy of a member (14 corresponding lines) (platforms/linux/src/ui/tray.py)
- Edited copy of a member (14 corresponding lines) (platforms/macos/Sources/Managers/PortForwardProcessManager+Kubernetes.swift)
- Edited copy of a member (14 corresponding lines) (platforms/macos/Sources/Services/PermissionService.swift)
- Edited copy of a member (15 corresponding lines) (platforms/macos/Sources/Views/CloudflareTunnels/CloudflareTunnelsView.swift)
- Edited copy of a member (16 corresponding lines) (platforms/windows/PortKiller/CloudflareTunnelsView.xaml.cs)
- Edited copy of a member (17 corresponding lines) (platforms/macos/Sources/Managers/NamedTunnelManager.swift)
- Edited copy of a member (17 corresponding lines) (platforms/macos/Sources/Views/CloudflareTunnels/NamedTunnelDetailView.swift)
- Edited copy of a member (17 corresponding lines) (platforms/windows/PortKiller/Services/PortScannerService.cs)
- Edited copy of a member (20 corresponding lines) (platforms/windows/PortKiller/MiniPortKillerWindow.xaml.cs)
- Edited copy of a member (21 corresponding lines) (platforms/macos/Sources/Views/SponsorsWindowView.swift)
- Edited copy of a member (24 corresponding lines) (platforms/macos/Sources/Managers/PortForwardManager+Execution.swift)
- Edited copy of a member (25 corresponding lines) (platforms/linux/src/ui/window.py)
- …and 16 more
Architecture
- Unchanged — 1 containers · 0 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
productdevbook/port-killer was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 2209b0fded4f58b8498aaf855e218a2a2b08067f — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.