Releases: kagehq/port-kill
Port Kill v0.1.19 - Release
🎉 Release v0.1.19
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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.18 - Release
🎉 Release v0.1.18
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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.17 - Release
🎉 Release v0.1.17
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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.16 - Release
🎉 Release v0.1.16
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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.15 - Release
🎉 Release v0.1.15
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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.14 - Release
🎉 Release v0.1.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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.13 - Release
🎉 Release v0.1.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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.12 - Release
🎉 Release v0.1.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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.10 - Release
🎉 Release v0.1.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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.1.9 - Release
🎉 Release v0.1.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 stop
withdocker rm -f
fallback
⚙️ 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,8000
Advanced 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)
lsof
command (included)
Linux
- GTK support (auto-fallback to console if missing)
- Rust 1.70+ (for building from source)
lsof
command- 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)
netstat
andtasklist
commands (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
docker
command 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.