A powerful Raycast extension to manage and monitor all listening ports and processes on your macOS system, including Docker containers.
- View all TCP and UDP listening ports on your system
- Real-time monitoring with automatic refresh every 4 seconds
- Display process names, PIDs, users, and resource usage (CPU & Memory)
- Identify which application is using which port
Provides a clean, minimal interface showing:
- Port number (e.g.,
:1800) - Protocol and application name
- Process ID (PID)
- User running the process
- CPU usage percentage
Detailed view with additional information:
- Full address and port in subtitle (e.g.,
127.0.0.1:1800) - Protocol type badge
- Application name
- Process ID and User ID
- CPU and Memory usage
- Detailed metadata panel on the right showing:
- Executable path
- Working directory
- Process start time
- Full command line arguments
Access filtering options via the dropdown menu:
- Show everything - Display all processes (default)
- Hide system processes - Filter out system processes (UID < 500 or system paths)
- Hide 0% CPU badges - Hide CPU usage badges when usage is 0%
- Hide system + 0% CPU - Combine both filters above
- Automatically detects Docker installation
- Lists all running containers with:
- Container name and image
- Port mappings
- CPU and Memory usage
- Container status
For each listening port, you can:
- Open in Browser (
↵) - Open http://localhost:port in your default browser - Copy address - Copy the host:port combination to clipboard
- Copy PID - Copy the process ID
- Copy command - Copy the full command/executable path
- Reveal app in Finder - Show the executable in Finder (when available)
- Open working folder - Open the process's working directory
- Stop nicely (
⌘ + ⌫) - Send SIGTERM to gracefully stop the process - Force stop (
⌘ + ⇧ + ⌫) - Send SIGKILL to forcefully terminate the process - Stop by port - Terminate all processes listening on a specific port
- Start Container - Start a stopped container
- Stop Container - Stop a running container
- Restart Container - Restart a container
- Open Shell - Open an interactive shell in the container
- View Logs - View container logs
- Copy Container ID - Copy the full container ID
↵- Open localhost URL in browser⌘ + ⌫- Stop process gracefully (SIGTERM)⌘ + ⇧ + ⌫- Force kill process (SIGKILL)⌘ + K- Show all available actions⌘ + R- Refresh the list manually
The extension automatically refreshes every 4 seconds to keep the information up-to-date, showing real-time CPU and memory usage.
npm install
npm run buildnpm run dev- macOS (uses system utilities like
lsof,ps, andkill) - Node.js 20.8.1 or later
- Raycast
The extension uses hardcoded paths to macOS system binaries for security:
/usr/sbin/lsof- List open files and network connections/bin/ps- Get process information/bin/kill- Send signals to processes
Automatically detects Docker in common installation paths:
/usr/local/bin/docker/opt/homebrew/bin/docker/usr/bin/docker
The extension intelligently resolves full application names from abbreviated process names returned by system utilities, ensuring you see "Spotify" instead of "Sp", "Google Chrome" instead of "Go", etc.
The extension automatically maps common abbreviated names to their full application names. If you see an unfamiliar abbreviation, it's likely a system process.
Ensure Docker Desktop is running and the Docker daemon is accessible. The extension will show "Docker not available" if it cannot connect to Docker.
System processes can be hidden using the "Hide system processes" filter option. These include processes running under system users or from system directories.
This extension only reads system information and does not transmit any data externally. All operations are performed locally on your machine using standard macOS utilities.
MIT