list

/list:working-tree

Enumerate all git worktrees and display metadata from .ai-context.json.

ARGUMENT SPECIFICATION

SYNTAX: /list:working-tree

NO ARGUMENTS

EXECUTION PROTOCOL

Execute steps sequentially. Each step must complete successfully before proceeding.

STEP 1: GET CURRENT WORKTREE

EXECUTE:

CURRENT_ROOT=$(git rev-parse --show-toplevel 2>&1)
EXIT_CODE=$?

VALIDATION:

• IF EXIT_CODE != 0 → ERROR PATTERN "not-in-git-repo"

NEXT:

• On success → STEP 2
• On failure → ABORT

STEP 2: LIST ALL WORKTREES

EXECUTE:

WORKTREE_LIST=$(git worktree list --porcelain 2>&1)
EXIT_CODE=$?

VALIDATION:

• IF EXIT_CODE != 0 → ERROR PATTERN "git-command-failed"

NEXT:

• On success → STEP 3
• On failure → ABORT

STEP 3: PARSE WORKTREES

PARSE FORMAT:

worktree /path/to/worktree
HEAD commit-hash
branch refs/heads/branch-name

worktree /another/path
HEAD commit-hash
branch refs/heads/another-branch

PARSING ALGORITHM:

worktrees = []
current_entry = {}

for line in WORKTREE_LIST.split("\n"):
    if line.startswith("worktree "):
        if current_entry:
            worktrees.append(current_entry)
        current_entry = {"path": line.split(" ", 1)[1]}
    elif line.startswith("branch refs/heads/"):
        current_entry["branch"] = line.split("/")[-1]
    elif line == "":
        if current_entry:
            worktrees.append(current_entry)
            current_entry = {}

if current_entry:
    worktrees.append(current_entry)

DATA EXTRACTED:

• List of worktree entries, each with:
  • path: absolute path to worktree
  • branch: branch name (without refs/heads/)

NEXT:

• On success → STEP 4
• No failure case (empty list is valid)

STEP 4: READ METADATA FOR EACH WORKTREE

FOR EACH worktree in worktrees:

METADATA_PATH="$worktree_path/.ai-context.json"
test -f "$METADATA_PATH"
HAS_METADATA=$?

if [ $HAS_METADATA -eq 0 ]; then
    METADATA=$(cat "$METADATA_PATH" 2>&1)
    MODE=$(echo "$METADATA" | jq -r '.mode // "(invalid)"' 2>&1)
    DESCRIPTION=$(echo "$METADATA" | jq -r '.description // ""' 2>&1)

    # Validate JSON
    if [ $? -ne 0 ]; then
        MODE="(invalid json)"
        DESCRIPTION=""
    fi
else
    MODE="(no metadata)"
    DESCRIPTION="-"
fi