A minimal, local-first Windows system-tray utility written in Rust that shows listening development ports and lets you safely stop their verified owning processes.

Stars

5

7-day growth

No data

Forks

0

Open issues

0

License

Apache-2.0

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It is purely local with no telemetry, cloud service, webview, or HTTP server; enforces a strict safety boundary by verifying process identity before any stop action, and avoids filesystem crawling to minimize latency and privacy exposure.

Who it is for

  • Developers running local web servers or dev backends
  • System administrators managing multiple development environments
  • Security-conscious users who want to control network listeners without extra services
  • Rust enthusiasts interested in local-first, privacy-respecting tools

Use cases

  • Quickly stopping a stuck development server from the system tray
  • Identifying which local ports are in use and by which processes
  • Safely terminating a listener without force-killing unrelated processes
  • Monitoring listening TCP endpoints without opening a full application window

Strengths

  • Written entirely in Rust with no heavy frameworks, minimizing resource usage
  • Verifies PID, start time, endpoint ownership, and classification before every stop action
  • Does not crawl filesystems, reducing latency and privacy exposure
  • Windows-first with clear documentation on build and verification steps

Considerations

  • Only Windows is supported in the initial release (no macOS or Linux yet)
  • The v0.1.0 executable is unsigned, requiring manual SHA-256 checksum verification
  • Uses force-stop warning on Windows due to lack of safe SIGTERM for external console servers

README quick start

Harry Porter

Harry Porter is a minimal, local-first system-tray utility that shows listening development ports and lets you stop their verified owning processes.

It is Windows-first and written entirely in Rust. There is no application window, React frontend, webview, Node.js runtime, drive crawl, account, cloud service, telemetry, or local HTTP control server.

What it does

  • reads structured listening TCP records from the operating system;
  • inspects only the unique processes that own those listeners;
  • groups ports as Development, Other/unknown, or System/protected;
  • hides system and infrastructure services by default without hiding uncertain processes;
  • marks listeners that accept connections from other devices;
  • refreshes every ten seconds, on demand, and when the tray is clicked;
  • verifies PID, start time, endpoint ownership, user scope, and classification immediately before any stop action;
  • attempts graceful stop where the platform safely supports it;
  • requires a separate review and confirmation before force stop;
  • rescans the endpoint and reports the observed result.

Harry Porter does not scan Git projects or the C: drive. Filesystem crawling would add latency and privacy exposure without proving which projects are actually listening.

Build and run

Prerequisites:

  • Rust stable;
  • on Windows, the MSVC Rust toolchain, Microsoft C++ Build Tools, and a Windows SDK.

Run the debug tray process:

cargo run -p harry-porter

Build the optimized executable:

cargo build --release -p harry-porter

The Windows executable is:

target/release/harry-porter.exe

Click the tray icon with either mouse button to open the native menu. No normal application window is created.

Download v0.1.0

The first release is a portable, unsigned Windows x86_64 build:

Extract the ZIP and run harry-porter.exe. Compare the archive against the published SHA-256 checksum before running it. Windows may warn about the unsigned executable. macOS is not included in v0.1.0 because its native tray and process-control path has not yet been verified on macOS hardware.

Verify

cargo fmt --all -- --check
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings

The Windows integration suite creates

Description

A local dev port manager built with Rust

Related repositories

Similar projects matched by category, topics, and programming language.

l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
steelbrain
Featured
steelbrain GitHub avatar

reims-vgpu

reims-vgpu is an experimental virtual GPU for macOS guests that uses QEMU to decode the guest's GPU command stream and execute it through Metal or Vulkan, leveraging the built-in AppleParavirtGPU driver without requiring custom kexts.

Desktop Apps
143
m-novotny
Featured
m-novotny GitHub avatar

memguard-rs

A Rust library that provides secure memory handling primitives including zeroization on drop, memory locking, constant-time comparison, and compile-time guarded regions, with zero dependencies and no_std support.

Embedded & IoTSecurity
131