Skip to content

README.md

Latest commit

 

History

History
109 lines (78 loc) · 3.4 KB

README.md

File metadata and controls

109 lines (78 loc) · 3.4 KB

DevKill

A Windows utility that finds and kills orphaned dev server processes hogging your ports.

Developers accumulate zombie dev servers — Node, .NET, Python, PHP, Vite, and others — that occupy ports and cause conflicts. DevKill auto-discovers these processes, shows them in a modern dark UI, and lets you kill them individually or in bulk.

Features

  • Auto-discovers listening ports via native Windows APIs (no netstat parsing)
  • Smart grouping — known dev server processes (Node, dotnet, Python, PHP, etc.) are surfaced in a "Dev Servers" group
  • Bulk kill — select multiple processes and kill them all at once
  • System tray — minimizes to tray with quick-kill context menu
  • CLI mode — run devkill 3000 to instantly free a port without opening the GUI
  • Auto-refresh — polls every 3 seconds for changes
  • Search/filter — filter by port number, process name, or PID
  • Start with Windows — optional auto-start via registry

Screenshots

DevKill main window

Requirements

  • Windows 10/11
  • .NET 10 Runtime
  • Administrator privileges (required to enumerate and kill all processes)

Installation

winget

winget install AndyBochmann.DevKill

Build from source

git clone https://github.com/andybochmann/DevKill.git
cd DevKill
dotnet build src/DevKill

Run

# GUI mode (launches with UAC prompt)
dotnet run --project src/DevKill

# CLI mode — kill process on port 3000
devkill 3000

# CLI mode — kill processes on multiple ports
devkill 3000 5000 8080

# Start minimized to tray
devkill --minimized

Tech Stack

Component Technology
Framework WPF on .NET 10
UI Theme WPF-UI (Fluent/WinUI dark theme)
MVVM CommunityToolkit.Mvvm
Port Scanning P/Invoke to iphlpapi.dll (GetExtendedTcpTable / GetExtendedUdpTable)

Project Structure

DevKill.sln
src/DevKill/
  App.xaml(.cs)          # Entry point, single-instance, CLI mode
  app.manifest           # UAC admin elevation
  Models/                # PortEntry data record
  Services/              # Port scanning (P/Invoke), process killing
  ViewModels/            # MVVM view models
  Views/                 # MainWindow with grouped DataGrid + tray
  Converters/            # Protocol badge colors
  Helpers/               # Windows startup registry
tests/DevKill.Tests/     # xUnit unit tests

Dev Server Detection

Processes are classified as dev servers by matching their process name against a whitelist:

node dotnet php iisexpress python python3 ruby java deno bun uvicorn gunicorn nginx httpd apache hugo caddy vite

Keyboard Shortcuts

Shortcut Action
Delete Kill selected process(es)
Ctrl+K / Ctrl+F Focus search box
Ctrl+A Select all
F5 Refresh
Escape Minimize to tray

Running Tests

dotnet test

License

MIT