🔌 Port Killer CLI

A beautiful, interactive Terminal User Interface (TUI) tool for managing and killing processes that are using specific ports on your system.

Features

• Beautiful TUI Interface: Clean, professional interface built with blessed
• Simple CLI Mode: Alternative command-line interface for scripting
• Real-time Port Scanning: Automatically detects and displays active ports
• Process Information: Shows detailed information about processes using each port
• Safe Process Killing: Confirmation dialog before killing processes
• Auto-refresh: Automatically refreshes port list every 5 seconds
• Keyboard Navigation: Intuitive keyboard shortcuts for quick operation
• Terminal Compatibility: Works with various terminal emulators

Installation

npm install
npm run build

Usage

Interactive TUI Mode (Default)

npm start
# or
node dist/index.js
# or explicitly
node dist/index.js --tui

Simple CLI Mode

# List all active ports
node dist/index.js --list

# Kill a specific port
node dist/index.js --kill 3000

# Show help
node dist/index.js --help

Keyboard Shortcuts

• ↑/↓ Arrow Keys: Navigate through the port list
• Enter / K: Kill the selected process (with confirmation)
• R: Refresh the port list manually
• Q / Ctrl+C: Quit the application
• Y/N: Confirm or cancel in the kill dialog

Interface

The application features a clean, divided interface:

• Header: Shows application title and keyboard shortcuts
• Port List (Left): Shows all active ports with process information
• Process Details (Right): Detailed information about the selected process
• Status Bar (Bottom): Current application status and messages
• Confirmation Dialog: Appears when killing a process

Requirements

• Node.js 16+
• macOS/Linux (uses lsof command)
• Terminal with color support

Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Lint
npm run lint

# Type check
npm run typecheck

Technical Details

• Built with TypeScript for type safety
• Uses blessed for the TUI interface
• Uses lsof command for port scanning
• Supports process killing with kill -9
• Auto-refresh functionality
• Graceful error handling

License

MIT