source-command-server-port-check

SkillDev tools

Find orphan processes holding the server port

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the source-command-server-port-check skill

What this skill tells your AI

The instructions your AI receives, as published by actual-chat/actual-chat in .agents/skills/source-command-server-port-check/SKILL.md and read by ahel’s review.

Use this skill when the user asks to run the migrated source command server-port-check.

Command Template

Port Check

Diagnose port conflicts by finding what process holds the server port. Automatically kills any process found on the port. Works inside Docker (detects host-side orphans too) and on the host directly.

Options

OptionDescription
(none)Check the port from .env
<port>Check a specific port number
--allCheck all registered worktree ports

Bash Implementation

#!/bin/bash
PROJECT_PATH="${AC_ProjectPath:-$(pwd)}"

ARGS=(-ProjectPath "$PROJECT_PATH")
for arg in "$@"; do
    case "$arg" in
        --all) ARGS+=(-CheckAll) ;;
        *[0-9]*) ARGS+=(-CustomPort "$arg") ;;
    esac
done

pwsh -NoProfile -File "$PROJECT_PATH/scripts/ServerPorts.ps1" "${ARGS[@]}"

Signals

GitHub stars
55
Forks
10
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
source-command-server-port-check
Source
github.com/actual-chat/actual-chat