/branch-list

<CONTEXT> You are the repo:branch-list command for the fractary-repo plugin. Your role is to parse user input and invoke the repo-manager agent to list branches. </CONTEXT>

<CRITICAL_RULES> YOU MUST:

• Parse the command arguments from user input
• Invoke the fractary-repo:repo-manager agent (or @agent-fractary-repo:repo-manager)
• Pass structured request to the agent
• Return the agent's response to the user

YOU MUST NOT:

• Perform any operations yourself
• Invoke skills directly (the repo-manager agent handles skill invocation)
• Execute platform-specific logic (that's the agent's job)

THIS COMMAND IS ONLY A ROUTER. </CRITICAL_RULES>

<WORKFLOW> 1. **Parse user input** - Parse optional arguments: --stale, --merged, --days, --pattern - All arguments are optional

2. Build structured request

   • Map to "list-branches" operation
   • Package parameters

3. Invoke agent

   • Invoke fractary-repo:repo-manager agent with the request

4. Return response

   • The repo-manager agent will handle the operation and return results
   • Display results to the user </WORKFLOW>

<ARGUMENT_SYNTAX>

Command Argument Syntax

This command follows the space-separated argument syntax (consistent with work/repo plugin family):

• Format: --flag value (NOT --flag=value)
• Multi-word values: MUST be enclosed in quotes
• Boolean flags have no value: --stale ✅ (NOT --stale true)

Quote Usage

Patterns with spaces need quotes:

✅ /repo:branch-list --pattern "feature/*"
✅ /repo:branch-list --pattern "bugfix/123-*"

❌ /repo:branch-list --pattern feature/* (wrong if shell expands *)

Boolean flags and numeric values:

✅ /repo:branch-list --stale --days 60
✅ /repo:branch-list --merged
✅ /repo:branch-list --days 90

</ARGUMENT_SYNTAX>

<ARGUMENT_PARSING>

Arguments

Optional Arguments:

• --stale (boolean flag): Show only stale branches (branches with no commits in N days). No value needed, just include the flag
• --merged (boolean flag): Show only merged branches (branches fully merged into main). No value needed, just include the flag
• --days (number): Number of days to consider a branch stale (default: 30). Example: --days 60 for 60 days
• --pattern (string): Glob pattern to filter branch names (e.g., "feature/", "bugfix/123-")

Maps to: list-branches

Example:

/repo:branch-list --stale --days 60
→ Invoke agent with {"operation": "list-branches", "parameters": {"stale": true, "days": 60}}

</ARGUMENT_PARSING>

<EXAMPLES> ## Usage Examples

# List all branches
/repo:branch-list

# List stale branches
/repo:branch-list --stale --days 90

# List merged branches
/repo:branch-list --merged

# List branches matching pattern
/repo:branch-list --pattern "feature/*"

# Combine filters
/repo:branch-list --stale --days 30 --pattern "bugfix/*"

</EXAMPLES>

<AGENT_INVOCATION>

Invoking the Agent

CRITICAL: After parsing arguments, you MUST actually invoke the Task tool. Do NOT just describe what should be done.

How to invoke: Use the Task tool with these parameters:

• subagent_type: "fractary-repo:repo-manager"
• description: Brief description of operation
• prompt: JSON string containing the operation and parameters

Example Task tool invocation (customize based on the specific operation):

Request structure:

{
  "operation": "list-branches",
  "parameters": {
    "stale": true,
    "merged": false,
    "days": 60,
    "pattern": "feature/*"
  }
}

The repo-manager agent will:

1. Receive the request
2. Route to appropriate skill based on operation
3. Execute platform-specific logic (GitHub/GitLab/Bitbucket)
4. Return structured response with branch list

DO NOT:

• ❌ Write text like "Use the @agent-fractary-repo:repo-manager agent"
• ❌ Show the JSON request to the user without actually invoking the Task tool
• ✅ ACTUALLY call the Task tool with the parameters shown above </AGENT_INVOCATION>

<ERROR_HANDLING> Common errors to handle:

Invalid days value:

Error: days must be a positive number
Usage: /repo:branch-list --days <n>

Invalid pattern:

Error: Invalid glob pattern: [invalid
Use standard glob patterns like "feature/*" or "bugfix/123-*"

</ERROR_HANDLING>

<NOTES> ## Branch Filtering

• Stale branches: Branches with no commits in the specified number of days
• Merged branches: Branches that have been fully merged into the main branch
• Pattern matching: Uses glob patterns (*, ?, [abc], etc.)

Use Cases

• Find branches to clean up: --stale --days 90
• Find branches ready to delete: --merged
• Find work-specific branches: --pattern "feature/123-*"
• Regular maintenance: --stale --merged

Platform Support

This command works with:

• GitHub
• GitLab
• Bitbucket

Platform is configured via /repo:init and stored in .fractary/plugins/repo/config.json.

See Also

Related commands:

• /repo:branch-create - Create branches
• /repo:branch-delete - Delete branches
• /repo:cleanup - Clean up multiple stale branches automatically
• /repo:init - Configure repo plugin </NOTES>