← Back to Skills Marketplace
damiencronw

Port Manager

by damienCronw · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
290
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install port-manager
Description
Port Manager - Track and manage system port usage. Use when: (1) Port conflict when installing software, (2) Check port usage, (3) Release occupied ports, (4...
Usage Guidance
What to check before installing: (1) Review the script contents yourself — it runs lsof/ps/jq and can call kill to terminate processes. (2) Ensure lsof and jq are present and trusted; the metadata should declare those dependencies but does not. (3) Note the inconsistent documented file location vs the script's actual path — verify where ports.json will be written and back it up if needed. (4) Prefer running the script manually first to confirm behavior and prompts; do not allow unattended/autonomous execution until you're comfortable it won't kill important services. (5) If you need stronger guarantees, request the package author to fix the metadata (declare binaries, correct file paths) and to add safer checks (e.g., extra confirmation, limited PID filtering) before trusting autonomous invocation.
Capability Analysis
Type: OpenClaw Skill Name: port-manager Version: 1.0.0 The 'port-manager' skill is a utility designed to track and manage system port usage, allowing users to record service ports, query occupancy, and free ports by terminating associated processes. The implementation in 'port.sh' uses standard system tools like lsof, ps, kill, and jq, and includes user confirmation prompts before killing processes. No evidence of data exfiltration, obfuscation, or malicious intent was found; the code's behavior is strictly aligned with its stated purpose.
Capability Assessment
Purpose & Capability
The skill's functionality (checking/listing/freeing ports) matches the script implementation, but the package metadata declares no required binaries while the script depends on system tools (lsof, jq, ps, kill). The SKILL.md and the script disagree about the ports.json location (SKILL.md: ~/.openclaw/workspace/.port-manager/ports.json vs script: ~/.openclaw/workspace/skills/port-manager/.data/ports.json). These mismatches are unexpected and should be corrected.
Instruction Scope
Instructions and script operate on system state: they run lsof/ps to enumerate processes, read/write a JSON file under your home workspace, and can terminate processes with kill. Terminating arbitrary processes is a high-impact action; although the script prompts for confirmation, an automated agent or a misused invocation could still terminate services. The SKILL.md also mentions netstat but the script uses lsof; minor mismatch but worth noting.
Install Mechanism
There is no external install/download step or remote code retrieval — the package is instruction+script only and writes files locally. No network fetches or archive extraction were found in the manifest.
Credentials
The skill requests no credentials, but it accesses the user's HOME to read/write ~/.openclaw workspace and queries system process/state (lsof/ps). It also requires jq and lsof which are not listed in metadata. The ability to inspect and terminate local processes is powerful and not represented in any declared permissions.
Persistence & Privilege
The skill persists its own data under ~/.openclaw/workspace/skills/port-manager/.data/ports.json (and includes sample .data files). It does not request always:true and does not modify other skills. However, because it can kill processes, consider the risk if the agent invokes this autonomously.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install port-manager
  3. After installation, invoke the skill by name or use /port-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Port Manager skill. - Track, record, and manage system port usage to avoid conflicts. - Record, query, and list service-port assignments. - Check for port conflicts and prompt to release ports. - Auto-allocate available ports if a requested port is occupied. - Free (terminate) processes occupying specified ports. - Stores port records in `~/.openclaw/workspace/.port-manager/ports.json`.
Metadata
Slug port-manager
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Port Manager?

Port Manager - Track and manage system port usage. Use when: (1) Port conflict when installing software, (2) Check port usage, (3) Release occupied ports, (4... It is an AI Agent Skill for Claude Code / OpenClaw, with 290 downloads so far.

How do I install Port Manager?

Run "/install port-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Port Manager free?

Yes, Port Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Port Manager support?

Port Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Port Manager?

It is built and maintained by damienCronw (@damiencronw); the current version is v1.0.0.

💬 Comments