A cross-platform CLI tool to terminate processes running on specific ports without complex shell commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install port-kill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install port-kill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Port Kill?
Port Kill is a robust utility designed to manage network processes with ease. As a highlighted entry in the Openclaw Skills directory, it replaces cumbersome shell pipes involving lsof, grep, and awk with a simple command-line interface. Whether you are dealing with a zombie process on macOS or a locked port on Windows, this tool provides a unified syntax for developers to reclaim their local environment and keep development moving forward.
This utility is built to be lightweight and zero-configuration, making it an ideal addition to any developer's toolkit. By abstracting the operating system's native process management tools, Port Kill ensures that your automation workflows remain consistent regardless of the underlying platform where Openclaw Skills are deployed.
Port Kill Use Cases
- Terminating stuck development servers like React, Vite, or Node.js on specific ports.
- Inspecting process metadata for specific ports before taking action to avoid accidental shutdowns.
- Automating port cleanup in local CI/CD pipelines or shell scripts.
- Finding the next available port in a sequence to avoid port collision during multi-service development.
How Port Kill Works
- The user initiates the command with a specific port number or a diagnostic flag like --check.
- The system identifies the underlying OS architecture to utilize native tools like netstat (Windows) or lsof/ss (macOS and Linux).
- The utility parses the active process table to isolate the exact Process ID (PID) utilizing the targeted port.
- It executes the termination signal or returns a status report based on the user's requested action within the Openclaw Skills environment.
Port Kill Setup
To begin using this tool, you can install it globally via npm or run it on-demand. This flexibility makes it perfect for integrating into various Openclaw Skills workflows.
# Install globally
npm install -g @lxgicstudios/port-kill
# Or run directly without installation
npx @lxgicstudios/port-kill 3000
Port Kill Data Schema & Taxonomy
The utility operates on a straightforward data structure to identify and manage process lifecycle events:
| Attribute | Type | Description |
|---|---|---|
| Port | Number | The network port specified for inspection or termination. |
| PID | Integer | The system-assigned Process Identifier associated with the port. |
| OS Logic | String | The detected platform logic (lsof, ss, or netstat) used for execution. |
| Force Flag | Boolean | Determines if a SIGKILL signal is sent to the process. |
Port Kill Advanced Features
- Force kill capability using -f or --force to handle stubborn or non-responsive background processes.
- Non-destructive listing mode with the --list flag to audit port usage without killing the process.
- Integrated port discovery using the --find parameter to locate the next free address in a range.
- Native cross-platform compatibility ensuring seamless behavior across Linux, macOS, and Windows environments using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Pitch Gen
A command-line utility that transforms startup ideas into comprehensive, investor-ready pitch deck content using AI.
Pitch Generator
Generate professional, structured startup pitch deck content instantly using AI.
Permission Auditor
An automated security tool that scans API route handlers to generate middleware-ready RBAC permission configurations.
Performance Auditor
A powerful AI-driven performance auditing tool that generates prioritized code fixes for Lighthouse reports.
PR Writer
An AI-powered CLI tool that analyzes git diffs to automatically generate comprehensive pull request titles and descriptions.
Prefetch Suggester
An AI-powered CLI utility that analyzes project routes to suggest and generate code for high-probability data and page prefetching.
Featured*
