@waoooo/claude-skills 1.0.0

package/skills/worktree-manager/config.json

@@ -0,0 +1,15 @@
+{
+  "terminal": "ghostty",
+  "shell": "fish",
+  "claudeCommand": "cc",
+  "portPool": {
+    "start": 8100,
+    "end": 8199
+  },
+  "portsPerWorktree": 2,
+  "worktreeBase": "~/.archon/worktrees",
+  "registryPath": "~/.claude/worktree-registry.json",
+  "defaultCopyDirs": [".agents", ".env.example", ".env"],
+  "healthCheckTimeout": 30,
+  "healthCheckRetries": 6
+}

package/skills/worktree-manager/scripts/allocate-ports.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# allocate-ports.sh - Allocate N unused ports from global pool
+#
+# Usage: ./allocate-ports.sh <count>
+#
+# Returns: Space-separated list of port numbers
+# Example: ./allocate-ports.sh 2 → "8100 8101"
+#
+# Also updates the registry to mark ports as allocated
+
+set -e
+
+COUNT="${1:-2}"
+
+# Validate input
+if ! [[ "$COUNT" =~ ^[0-9]+$ ]] || [ "$COUNT" -lt 1 ]; then
+    echo "Error: Count must be a positive integer" >&2
+    exit 1
+fi
+
+# Find config and registry
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CONFIG_FILE="$SCRIPT_DIR/../config.json"
+REGISTRY="${HOME}/.claude/worktree-registry.json"
+
+# Load port pool from config
+if [ -f "$CONFIG_FILE" ] && command -v jq &> /dev/null; then
+    PORT_START=$(jq -r '.portPool.start // 8100' "$CONFIG_FILE")
+    PORT_END=$(jq -r '.portPool.end // 8199' "$CONFIG_FILE")
+else
+    PORT_START=8100
+    PORT_END=8199
+fi
+
+# Check jq is available
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required. Install with: brew install jq" >&2
+    exit 1
+fi
+
+# Initialize registry if it doesn't exist
+if [ ! -f "$REGISTRY" ]; then
+    mkdir -p "$(dirname "$REGISTRY")"
+    cat > "$REGISTRY" << EOF
+{
+  "worktrees": [],
+  "portPool": {
+    "start": $PORT_START,
+    "end": $PORT_END,
+    "allocated": []
+  }
+}
+EOF
+fi
+
+# Get currently allocated ports from registry
+ALLOCATED_PORTS=$(jq -r '.portPool.allocated // [] | .[]' "$REGISTRY" 2>/dev/null || echo "")
+
+# Function to check if port is in use (by system or in registry)
+is_port_available() {
+    local port=$1
+
+    # Check if in registry's allocated list
+    if echo "$ALLOCATED_PORTS" | grep -q "^${port}$"; then
+        return 1
+    fi
+
+    # Check if port is actually in use by system
+    if lsof -i :"$port" &>/dev/null; then
+        return 1
+    fi
+
+    return 0
+}
+
+# Find available ports
+FOUND_PORTS=()
+for ((port=PORT_START; port<=PORT_END; port++)); do
+    if is_port_available "$port"; then
+        FOUND_PORTS+=("$port")
+        if [ ${#FOUND_PORTS[@]} -eq "$COUNT" ]; then
+            break
+        fi
+    fi
+done
+
+# Check if we found enough ports
+if [ ${#FOUND_PORTS[@]} -lt "$COUNT" ]; then
+    echo "Error: Could not find $COUNT available ports in range $PORT_START-$PORT_END" >&2
+    echo "Found only: ${FOUND_PORTS[*]}" >&2
+    exit 1
+fi
+
+# Update registry with newly allocated ports
+TMP=$(mktemp)
+PORTS_JSON=$(printf '%s\n' "${FOUND_PORTS[@]}" | jq -R 'tonumber' | jq -s .)
+jq ".portPool.allocated = ((.portPool.allocated // []) + $PORTS_JSON | unique | sort_by(.))" "$REGISTRY" > "$TMP" && mv "$TMP" "$REGISTRY"
+
+# Output the ports (space-separated)
+echo "${FOUND_PORTS[*]}"

package/skills/worktree-manager/scripts/cleanup.sh

@@ -0,0 +1,185 @@
+#!/bin/bash
+# cleanup.sh - Full cleanup of a worktree (ports, directory, registry, optionally branch)
+#
+# Usage: ./cleanup.sh <project> <branch> [--delete-branch]
+#        ./cleanup.sh --merged [--delete-branch]
+#
+# Examples:
+#   ./cleanup.sh obsidian-ai-agent feature/auth                    # Cleanup worktree only
+#   ./cleanup.sh obsidian-ai-agent feature/auth --delete-branch    # Also delete git branch
+#   ./cleanup.sh --merged                                          # Cleanup all merged worktrees
+#   ./cleanup.sh --merged --delete-branch                          # Also delete branches
+#
+# This script:
+# 1. Kills processes on allocated ports
+# 2. Removes the worktree directory
+# 3. Prunes git worktree references
+# 4. Removes entry from global registry
+# 5. Releases ports back to pool
+# 6. Optionally deletes local and remote git branches
+
+set -e
+
+REGISTRY="${HOME}/.claude/worktree-registry.json"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Handle --merged mode
+if [ "$1" = "--merged" ]; then
+    DELETE_BRANCH="${2:-}"
+
+    echo "Finding worktrees with merged PRs..."
+    echo "─────────────────────────────────────────────────────────"
+
+    CLEANED=0
+    SKIPPED=0
+
+    while IFS= read -r entry; do
+        [ -z "$entry" ] && continue
+
+        PROJECT=$(echo "$entry" | jq -r '.project')
+        BRANCH=$(echo "$entry" | jq -r '.branch')
+
+        # Check PR status
+        PR_INFO=$(gh pr list --head "$BRANCH" --state all --json number,state --limit 1 2>/dev/null || echo "[]")
+        PR_STATE=$(echo "$PR_INFO" | jq -r '.[0].state // "NONE"')
+        PR_NUM=$(echo "$PR_INFO" | jq -r '.[0].number // "?"')
+
+        if [ "$PR_STATE" = "MERGED" ]; then
+            echo ""
+            echo "Found merged: $PROJECT / $BRANCH (PR #$PR_NUM)"
+            "$SCRIPT_DIR/cleanup.sh" "$PROJECT" "$BRANCH" $DELETE_BRANCH
+            CLEANED=$((CLEANED + 1))
+        else
+            SKIPPED=$((SKIPPED + 1))
+        fi
+
+    done < <(jq -c '.worktrees[]' "$REGISTRY" 2>/dev/null)
+
+    echo ""
+    echo "─────────────────────────────────────────────────────────"
+    echo "Cleaned: $CLEANED worktrees"
+    echo "Skipped: $SKIPPED worktrees (not merged)"
+    exit 0
+fi
+
+PROJECT="$1"
+BRANCH="$2"
+DELETE_BRANCH="${3:-}"
+
+if [ -z "$PROJECT" ] || [ -z "$BRANCH" ]; then
+    echo "Usage: $0 <project> <branch> [--delete-branch]"
+    echo "       $0 --merged [--delete-branch]"
+    exit 1
+fi
+
+# Check jq is available
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required. Install with: brew install jq"
+    exit 1
+fi
+
+# Check if registry exists
+if [ ! -f "$REGISTRY" ]; then
+    echo "Error: No registry found at: $REGISTRY"
+    exit 1
+fi
+
+echo "Cleaning up: $PROJECT / $BRANCH"
+echo "─────────────────────────────────────────────────────────"
+
+# Find worktree entry in registry
+ENTRY=$(jq -c ".worktrees[] | select(.project == \"$PROJECT\" and .branch == \"$BRANCH\")" "$REGISTRY" 2>/dev/null || echo "")
+
+if [ -z "$ENTRY" ]; then
+    echo "Warning: Worktree not found in registry"
+    echo "Attempting cleanup based on project/branch names..."
+fi
+
+# Get details from entry (or defaults)
+if [ -n "$ENTRY" ]; then
+    WORKTREE_PATH=$(echo "$ENTRY" | jq -r '.worktreePath')
+    REPO_PATH=$(echo "$ENTRY" | jq -r '.repoPath')
+    PORTS=$(echo "$ENTRY" | jq -r '.ports[]' 2>/dev/null || echo "")
+else
+    # Construct default path
+    BRANCH_SLUG=$(echo "$BRANCH" | tr '/' '-')
+    WORKTREE_PATH="$HOME/tmp/worktrees/$PROJECT/$BRANCH_SLUG"
+    REPO_PATH=""
+    PORTS=""
+fi
+
+# Step 1: Kill processes on ports
+if [ -n "$PORTS" ]; then
+    echo "Killing processes on allocated ports..."
+    for PORT in $PORTS; do
+        if lsof -ti:"$PORT" &>/dev/null; then
+            lsof -ti:"$PORT" | xargs kill -9 2>/dev/null && echo "  Killed process on port $PORT" || echo "  Failed to kill on port $PORT"
+        else
+            echo "  Port $PORT: no process"
+        fi
+    done
+else
+    echo "No ports registered, skipping port cleanup"
+fi
+
+# Step 2: Remove worktree directory
+if [ -d "$WORKTREE_PATH" ]; then
+    echo "Removing worktree directory: $WORKTREE_PATH"
+
+    # Try to find the main repo to run git worktree remove
+    if [ -n "$REPO_PATH" ] && [ -d "$REPO_PATH" ]; then
+        cd "$REPO_PATH"
+        git worktree remove "$WORKTREE_PATH" --force 2>/dev/null && echo "  Removed via git worktree" || {
+            echo "  Git worktree remove failed, removing directory directly..."
+            rm -rf "$WORKTREE_PATH" && echo "  Removed directory"
+        }
+    else
+        # Just remove the directory
+        rm -rf "$WORKTREE_PATH" && echo "  Removed directory"
+    fi
+else
+    echo "Worktree directory not found: $WORKTREE_PATH"
+fi
+
+# Step 3: Prune stale worktree references
+if [ -n "$REPO_PATH" ] && [ -d "$REPO_PATH" ]; then
+    echo "Pruning stale git worktree references..."
+    cd "$REPO_PATH"
+    git worktree prune 2>/dev/null && echo "  Pruned" || echo "  Prune skipped"
+fi
+
+# Step 4: Remove from registry and release ports
+echo "Updating global registry..."
+TMP=$(mktemp)
+
+# Remove worktree entry
+jq "del(.worktrees[] | select(.project == \"$PROJECT\" and .branch == \"$BRANCH\"))" "$REGISTRY" > "$TMP"
+
+# Release ports from allocated pool
+if [ -n "$PORTS" ]; then
+    for PORT in $PORTS; do
+        jq ".portPool.allocated = (.portPool.allocated | map(select(. != $PORT)))" "$TMP" > "${TMP}.2" && mv "${TMP}.2" "$TMP"
+    done
+    echo "  Released ports: $PORTS"
+fi
+
+mv "$TMP" "$REGISTRY"
+echo "  Registry updated"
+
+# Step 5: Delete git branches (if requested)
+if [ "$DELETE_BRANCH" = "--delete-branch" ]; then
+    if [ -n "$REPO_PATH" ] && [ -d "$REPO_PATH" ]; then
+        cd "$REPO_PATH"
+
+        echo "Deleting local branch: $BRANCH"
+        git branch -D "$BRANCH" 2>/dev/null && echo "  Deleted local branch" || echo "  Local branch not found or is current branch"
+
+        echo "Deleting remote branch: $BRANCH"
+        git push origin --delete "$BRANCH" 2>/dev/null && echo "  Deleted remote branch" || echo "  Remote branch not found or already deleted"
+    else
+        echo "Cannot delete branches: original repo path not found"
+    fi
+fi
+
+echo "─────────────────────────────────────────────────────────"
+echo "✅ Cleanup complete: $PROJECT / $BRANCH"

package/skills/worktree-manager/scripts/launch-agent.sh

@@ -0,0 +1,155 @@
+#!/bin/bash
+# launch-agent.sh - Launch Claude Code in a new Ghostty terminal for a worktree
+#
+# Usage: ./launch-agent.sh <worktree-path> [task-description]
+#
+# Examples:
+#   ./launch-agent.sh ~/tmp/worktrees/my-project/feature-auth
+#   ./launch-agent.sh ~/tmp/worktrees/my-project/feature-auth "Implement OAuth login"
+
+set -e
+
+WORKTREE_PATH="$1"
+TASK="$2"
+
+# Validate input
+if [ -z "$WORKTREE_PATH" ]; then
+    echo "Error: Worktree path required"
+    echo "Usage: $0 <worktree-path> [task-description]"
+    exit 1
+fi
+
+# Find script directory and config
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CONFIG_FILE="$SCRIPT_DIR/../config.json"
+
+# Load config (with defaults)
+if [ -f "$CONFIG_FILE" ] && command -v jq &> /dev/null; then
+    TERMINAL=$(jq -r '.terminal // "ghostty"' "$CONFIG_FILE")
+    SHELL_CMD=$(jq -r '.shell // "fish"' "$CONFIG_FILE")
+    CLAUDE_CMD=$(jq -r '.claudeCommand // "cc"' "$CONFIG_FILE")
+else
+    TERMINAL="ghostty"
+    SHELL_CMD="fish"
+    CLAUDE_CMD="cc"
+fi
+
+# Note: CLAUDE_CMD (default "cc") is configurable in config.json
+# It runs inside the target shell (fish) which should have the alias defined
+# Falls back to "claude" if the alias/command fails
+
+# Expand ~ in path
+WORKTREE_PATH="${WORKTREE_PATH/#\~/$HOME}"
+
+# Convert to absolute path if relative
+if [[ "$WORKTREE_PATH" != /* ]]; then
+    WORKTREE_PATH="$(pwd)/$WORKTREE_PATH"
+fi
+
+# Verify worktree exists
+if [ ! -d "$WORKTREE_PATH" ]; then
+    echo "Error: Worktree directory does not exist: $WORKTREE_PATH"
+    exit 1
+fi
+
+# Verify it's a git worktree (has .git file or directory)
+if [ ! -e "$WORKTREE_PATH/.git" ]; then
+    echo "Error: Not a git worktree: $WORKTREE_PATH"
+    exit 1
+fi
+
+# Get branch name
+BRANCH=$(cd "$WORKTREE_PATH" && git branch --show-current 2>/dev/null || basename "$WORKTREE_PATH")
+
+# Get project name from path
+PROJECT=$(basename "$(dirname "$WORKTREE_PATH")")
+
+# Build the command to run in the new terminal
+# Use configured command (cc) - fish syntax compatible
+# For fish: use 'or' instead of '||' for fallback, and avoid subshells
+if [ "$SHELL_CMD" = "fish" ]; then
+    if [ -n "$TASK" ]; then
+        INNER_CMD="cd '$WORKTREE_PATH'; and echo '🌳 Worktree: $PROJECT / $BRANCH'; and echo '📋 Task: $TASK'; and echo ''; and $CLAUDE_CMD; or claude"
+    else
+        INNER_CMD="cd '$WORKTREE_PATH'; and echo '🌳 Worktree: $PROJECT / $BRANCH'; and echo ''; and $CLAUDE_CMD; or claude"
+    fi
+else
+    # bash/zsh syntax
+    if [ -n "$TASK" ]; then
+        INNER_CMD="cd '$WORKTREE_PATH' && echo '🌳 Worktree: $PROJECT / $BRANCH' && echo '📋 Task: $TASK' && echo '' && ($CLAUDE_CMD || claude)"
+    else
+        INNER_CMD="cd '$WORKTREE_PATH' && echo '🌳 Worktree: $PROJECT / $BRANCH' && echo '' && ($CLAUDE_CMD || claude)"
+    fi
+fi
+
+# Launch based on terminal type
+case "$TERMINAL" in
+    ghostty)
+        if ! command -v ghostty &> /dev/null && [ ! -d "/Applications/Ghostty.app" ]; then
+            echo "Error: Ghostty not found"
+            exit 1
+        fi
+        # Launch Ghostty with the command
+        open -na "Ghostty.app" --args -e "$SHELL_CMD" -c "$INNER_CMD"
+        ;;
+
+    iterm2|iterm)
+        osascript <<EOF
+tell application "iTerm2"
+    create window with default profile
+    tell current session of current window
+        write text "cd '$WORKTREE_PATH' && $CLAUDE_CMD"
+    end tell
+end tell
+EOF
+        ;;
+
+    tmux)
+        if ! command -v tmux &> /dev/null; then
+            echo "Error: tmux not found"
+            exit 1
+        fi
+        SESSION_NAME="wt-$PROJECT-$(echo "$BRANCH" | tr '/' '-')"
+        tmux new-session -d -s "$SESSION_NAME" -c "$WORKTREE_PATH" "$SHELL_CMD -c '$CLAUDE_CMD'"
+        echo "   tmux session: $SESSION_NAME (attach with: tmux attach -t $SESSION_NAME)"
+        ;;
+
+    wezterm)
+        if ! command -v wezterm &> /dev/null; then
+            echo "Error: WezTerm not found"
+            exit 1
+        fi
+        wezterm start --cwd "$WORKTREE_PATH" -- "$SHELL_CMD" -c "$INNER_CMD"
+        ;;
+
+    kitty)
+        if ! command -v kitty &> /dev/null; then
+            echo "Error: Kitty not found"
+            exit 1
+        fi
+        kitty --detach --directory "$WORKTREE_PATH" "$SHELL_CMD" -c "$INNER_CMD"
+        ;;
+
+    alacritty)
+        if ! command -v alacritty &> /dev/null; then
+            echo "Error: Alacritty not found"
+            exit 1
+        fi
+        alacritty --working-directory "$WORKTREE_PATH" -e "$SHELL_CMD" -c "$INNER_CMD" &
+        ;;
+
+    *)
+        echo "Error: Unknown terminal type: $TERMINAL"
+        echo "Supported: ghostty, iterm2, tmux, wezterm, kitty, alacritty"
+        exit 1
+        ;;
+esac
+
+echo "✅ Launched Claude Code agent"
+echo "   Terminal: $TERMINAL"
+echo "   Project: $PROJECT"
+echo "   Branch: $BRANCH"
+echo "   Path: $WORKTREE_PATH"
+if [ -n "$TASK" ]; then
+    echo "   Task: $TASK"
+fi

package/skills/worktree-manager/scripts/register.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+# register.sh - Register a worktree in the global registry
+#
+# Usage: ./register.sh <project> <branch> <branch-slug> <worktree-path> <repo-path> <ports> [task]
+#
+# Arguments:
+#   project       - Project name (e.g., "obsidian-ai-agent")
+#   branch        - Full branch name (e.g., "feature/auth")
+#   branch-slug   - Slugified branch (e.g., "feature-auth")
+#   worktree-path - Full path to worktree
+#   repo-path     - Full path to original repo
+#   ports         - Comma-separated ports (e.g., "8100,8101")
+#   task          - Optional task description
+#
+# Example:
+#   ./register.sh obsidian-ai-agent feature/auth feature-auth \
+#     ~/tmp/worktrees/obsidian-ai-agent/feature-auth \
+#     ~/Projects/obsidian-ai-agent \
+#     8100,8101 "Implement OAuth"
+
+set -e
+
+PROJECT="$1"
+BRANCH="$2"
+BRANCH_SLUG="$3"
+WORKTREE_PATH="$4"
+REPO_PATH="$5"
+PORTS="$6"
+TASK="${7:-}"
+
+# Validate inputs
+if [ -z "$PROJECT" ] || [ -z "$BRANCH" ] || [ -z "$BRANCH_SLUG" ] || [ -z "$WORKTREE_PATH" ] || [ -z "$REPO_PATH" ] || [ -z "$PORTS" ]; then
+    echo "Usage: $0 <project> <branch> <branch-slug> <worktree-path> <repo-path> <ports> [task]"
+    exit 1
+fi
+
+REGISTRY="${HOME}/.claude/worktree-registry.json"
+
+# Check jq is available
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required. Install with: brew install jq"
+    exit 1
+fi
+
+# Expand ~ in paths
+WORKTREE_PATH="${WORKTREE_PATH/#\~/$HOME}"
+REPO_PATH="${REPO_PATH/#\~/$HOME}"
+
+# Initialize registry if it doesn't exist
+if [ ! -f "$REGISTRY" ]; then
+    mkdir -p "$(dirname "$REGISTRY")"
+    cat > "$REGISTRY" << 'EOF'
+{
+  "worktrees": [],
+  "portPool": {
+    "start": 8100,
+    "end": 8199,
+    "allocated": []
+  }
+}
+EOF
+fi
+
+# Check if already registered - release old ports before updating
+if jq -e ".worktrees[] | select(.project == \"$PROJECT\" and .branch == \"$BRANCH\")" "$REGISTRY" > /dev/null 2>&1; then
+    echo "Warning: Worktree already registered, updating..."
+
+    # Get old ports to release them
+    OLD_PORTS=$(jq -r ".worktrees[] | select(.project == \"$PROJECT\" and .branch == \"$BRANCH\") | .ports[]" "$REGISTRY" 2>/dev/null || echo "")
+
+    TMP=$(mktemp)
+    # Remove old entry
+    jq "del(.worktrees[] | select(.project == \"$PROJECT\" and .branch == \"$BRANCH\"))" "$REGISTRY" > "$TMP"
+
+    # Release old ports from pool
+    if [ -n "$OLD_PORTS" ]; then
+        for OLD_PORT in $OLD_PORTS; do
+            jq ".portPool.allocated = (.portPool.allocated | map(select(. != $OLD_PORT)))" "$TMP" > "${TMP}.2" && mv "${TMP}.2" "$TMP"
+        done
+        echo "   Released old ports: $OLD_PORTS"
+    fi
+
+    mv "$TMP" "$REGISTRY"
+fi
+
+# Parse ports into JSON array
+PORTS_JSON=$(echo "$PORTS" | tr ',' '\n' | jq -R 'tonumber' | jq -s .)
+
+# Format task
+if [ -n "$TASK" ]; then
+    TASK_JSON="\"$TASK\""
+else
+    TASK_JSON="null"
+fi
+
+# Generate UUID
+UUID=$(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid 2>/dev/null || echo "wt-$(date +%s)-$$")
+
+# Add entry
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+TMP=$(mktemp)
+jq ".worktrees += [{
+    \"id\": \"$UUID\",
+    \"project\": \"$PROJECT\",
+    \"repoPath\": \"$REPO_PATH\",
+    \"branch\": \"$BRANCH\",
+    \"branchSlug\": \"$BRANCH_SLUG\",
+    \"worktreePath\": \"$WORKTREE_PATH\",
+    \"ports\": $PORTS_JSON,
+    \"createdAt\": \"$TIMESTAMP\",
+    \"validatedAt\": null,
+    \"agentLaunchedAt\": null,
+    \"task\": $TASK_JSON,
+    \"prNumber\": null,
+    \"status\": \"active\"
+}]" "$REGISTRY" > "$TMP" && mv "$TMP" "$REGISTRY"
+
+echo "✅ Registered worktree:"
+echo "   Project: $PROJECT"
+echo "   Branch: $BRANCH"
+echo "   Path: $WORKTREE_PATH"
+echo "   Ports: $PORTS"
+if [ -n "$TASK" ]; then
+    echo "   Task: $TASK"
+fi

package/skills/worktree-manager/scripts/release-ports.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# release-ports.sh - Release ports back to the global pool
+#
+# Usage: ./release-ports.sh <port1> [port2] [port3] ...
+#
+# Example: ./release-ports.sh 8100 8101
+
+set -e
+
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <port1> [port2] [port3] ..."
+    exit 1
+fi
+
+REGISTRY="${HOME}/.claude/worktree-registry.json"
+
+# Check jq is available
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required. Install with: brew install jq"
+    exit 1
+fi
+
+# Check if registry exists
+if [ ! -f "$REGISTRY" ]; then
+    echo "No registry found, nothing to release"
+    exit 0
+fi
+
+TMP=$(mktemp)
+cp "$REGISTRY" "$TMP"
+
+RELEASED=()
+for PORT in "$@"; do
+    if [[ "$PORT" =~ ^[0-9]+$ ]]; then
+        jq ".portPool.allocated = (.portPool.allocated | map(select(. != $PORT)))" "$TMP" > "${TMP}.2" && mv "${TMP}.2" "$TMP"
+        RELEASED+=("$PORT")
+    else
+        echo "Warning: Invalid port number: $PORT" >&2
+    fi
+done
+
+mv "$TMP" "$REGISTRY"
+
+if [ ${#RELEASED[@]} -gt 0 ]; then
+    echo "Released ports: ${RELEASED[*]}"
+else
+    echo "No ports released"
+fi