PortKeep
/install portkeep
PortKeep
Port management + security for self-hosted infrastructure.
When to use
- User asks about open ports, listening services, or what's running on a port
- User wants to audit their network security or attack surface
- User needs to claim/register a port to prevent conflicts
- User wants to check for port drift (declared vs actual ports)
- User mentions threat intel, C2 detection, or CVE exposure on their ports
- User wants to monitor ports across multiple nodes
Install
brew tap jchandler187/tap
brew install portkeep
Or download from https://github.com/jchandler187/portkeep/releases/latest
Commands
| Command | What it does |
|---|---|
portkeep scan |
Discover all listening ports |
portkeep scan --node NAME |
Scan a remote node via SSH |
portkeep audit |
Security audit — score, C2 matches, CVEs, firewall |
portkeep sync |
Fetch and cache threat intel (9 sources) |
portkeep claim 3000 "api" |
Register a port as expected |
portkeep claim next |
Find next available port |
portkeep drift |
Declared vs actual — exits 1 on drift (cron-ready) |
portkeep list |
List all registered claims |
portkeep history |
Port change timeline |
portkeep node add NAME --host IP |
Add a remote node |
portkeep daemon start |
Background monitoring service |
All commands support --json for scripting and --quiet for cron.
Threat Intel Sources
6 work out of the box (no API key):
- CISA-KEV, EPSS, Feodo Tracker, blocklist.de, Emerging Threats, DShield/SANS
3 require a free abuse.ch Auth-Key:
- ThreatFox, URLhaus, MalwareBazaar
Set ABUSE_CH_AUTH_KEY in environment to enable all 9.
Examples
# First run — sync threat intel, then audit
portkeep sync
portkeep audit
# Register your services
portkeep claim 22 "ssh"
portkeep claim 3000 "grafana"
portkeep claim 8080 "api"
# Check for unexpected ports (great for cron)
portkeep drift
# Add a second machine
portkeep node add prod --host 10.0.0.5 --ssh-key ~/.ssh/id_ed25519
portkeep scan --node prod
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install portkeep - After installation, invoke the skill by name or use
/portkeep - Provide required inputs per the skill's parameter spec and get structured output
What is PortKeep?
Manage, secure, and monitor open ports and services across nodes with audit, claim, drift detection, threat intel, and background monitoring. It is an AI Agent Skill for Claude Code / OpenClaw, with 42 downloads so far.
How do I install PortKeep?
Run "/install portkeep" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PortKeep free?
Yes, PortKeep is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does PortKeep support?
PortKeep is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PortKeep?
It is built and maintained by Lowwattlabs (@jchandler187); the current version is v1.0.0.