Port Registry

Use this skill to view port assignments and find available ports.

Steps

1. Show Current Assignments

Read and display ~/dev/github/PORTS.md:

cat ~/dev/github/PORTS.md

2. Check for Running Services

Show which registered ports are currently in use:

for port in 3000 5173 8000 8001 8080 8888; do
  if ss -tuln | grep -q ":$port "; then
    echo "Port $port: IN USE"
  else
    echo "Port $port: available"
  fi
done

3. Find Next Available

Based on the "Next Available" section in PORTS.md, suggest:

• Next Python backend port (8000 range)
• Next JS/Node port (3000 range)
• Next frontend dev port (5000 range)

4. Optional: Register New Port

If user is creating a new app, update PORTS.md:

1. Add new row to the port table
2. Update "Next Available" section

Output Format

PORT REGISTRY
=============
| Port | Project        | Status      |
|------|----------------|-------------|
| 3000 | ynab           | available   |
| 8000 | serendipity    | IN USE      |
| 8001 | llm-council    | available   |
| ...  | ...            | ...         |

NEXT AVAILABLE
- Python backend: 8002
- JS/Node app: 3001
- Frontend dev: 5174