Releases: treadiehq/port-kill
Port Kill v0.3.1 - Release
π Release v0.3.1
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.3.0 - Release
π Release v0.3.0
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.14 - Release
π Release v0.2.14
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.13 - Release
π Release v0.2.13
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.12 - Release
π Release v0.2.12
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.11 - Release
π Release v0.2.11
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.10 - Release
π Release v0.2.10
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.9 - Release
π Release v0.2.9
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.8 - Release
π Release v0.2.8
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.
Port Kill v0.2.7 - Release
π Release v0.2.7
Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.
β¨ Key Features
π Cross-Platform Support
- macOS: Native system tray with dynamic context menu
- Linux: Native system tray with GTK integration (auto-fallback to console)
- Windows: Native system tray with full functionality
- Console Mode: Works on all platforms without GUI dependencies
π Process Monitoring
- Real-time scanning: Monitors configurable ports every 5 seconds
- Smart detection: Identifies processes by name, PID, and Docker containers
- Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
- Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)
π‘οΈ Safe Process Management
- Individual killing: Kill specific processes by clicking menu items
- Bulk operations: Kill all detected processes with one click
- Safe termination: SIGTERM β SIGKILL strategy with graceful fallback
- Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)
π³ Docker Integration
- Container detection: Shows Docker container names and IDs
- Container management: Automatically stops containers when killing processes
- Graceful handling: Uses
docker stopwithdocker rm -ffallback
βοΈ Advanced Features
- Log level control: Configurable verbosity (info, warn, error, none)
- PID display: Optional process ID display for better identification
- Full-screen support: Console mode recommended for full-screen applications
- Error handling: Graceful handling of permission errors and process failures
π Quick Installation
Automated Install (Recommended)
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash
# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"Manual Installation
# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.shπ¦ Included Binaries
System Tray Mode (GUI)
- macOS:
port-kill-macos - Linux:
port-kill-linux - Windows:
port-kill-windows.exe
Console Mode (No GUI Dependencies)
- macOS:
port-kill-console-macos - Linux:
port-kill-console-linux - Windows:
port-kill-console-windows.exe
π― Usage Examples
Basic Usage
# Default monitoring (ports 2000-6000)
./run.sh # macOS
./run-linux.sh # Linux
run-windows.bat # Windows
# Monitor specific ports
./run.sh --ports 3000,8000,8080
# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000Advanced Usage
# Docker integration
./run.sh --docker --ports 3000,3001,8000
# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe
# Custom log level
./run.sh --log-level warn --ports 3000,8000π§ System Requirements
macOS
- macOS 10.15 or later
- Rust 1.70+ (for building from source)
lsofcommand (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsofcommand- Required packages:
libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev
Windows
- Windows 10 or later
- Rust 1.70+ (for building from source)
netstatandtasklistcommands (included)
π Known Issues & Solutions
Full-Screen Mode
- Issue: System tray menu not accessible in full-screen
- Solution: Use console mode:
./run.sh --console --ports 3000,8000
Linux GTK Issues
- Issue: GTK initialization errors
- Solution: Install GTK packages or use console mode
Docker Integration
- Issue: Docker containers not detected
- Solution: Ensure Docker Desktop is running and
dockercommand is available
π Documentation
- Full Documentation: README.md
- Troubleshooting: Troubleshooting Guide
- Community: Discord Server
π€ Contributing
We welcome contributions! Please see our Contributing Guide for details.
π License
This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.
Happy coding! π
Port Kill - Making development process management simple and cross-platform.