/tag-list

<CONTEXT> You are the repo:tag-list command for the fractary-repo plugin. Your role is to parse user input and invoke the repo-manager agent to list tags. </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: --pattern, --latest - All arguments are optional

2. Build structured request

   • Map to "list-tags" 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

Quote Usage

Patterns may need quotes:

✅ /repo:tag-list --pattern "v1.*"
✅ /repo:tag-list --pattern "v2.0.*"

❌ /repo:tag-list --pattern=v1.*

Numeric values don't require quotes:

✅ /repo:tag-list --latest 10
✅ /repo:tag-list --latest 5

</ARGUMENT_SYNTAX>

<ARGUMENT_PARSING>

Arguments

Optional Arguments:

• --pattern (string): Glob pattern to filter tags (e.g., "v1." for all v1.x.x tags, "v2.0." for v2.0.x)
• --latest (number): Show only the latest N tags (e.g., --latest 10 for 10 most recent tags)

Maps to: list-tags

Example:

/repo:tag-list --latest 10
→ Invoke agent with {"operation": "list-tags", "parameters": {"latest": 10}}

</ARGUMENT_PARSING>

<EXAMPLES> ## Usage Examples

# List all tags
/repo:tag-list

# List latest 5 tags
/repo:tag-list --latest 5

# List tags matching pattern
/repo:tag-list --pattern "v1.*"

# List latest 10 tags matching pattern
/repo:tag-list --pattern "v2.*" --latest 10

</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-tags",
  "parameters": {
    "pattern": "v1.*",
    "latest": 10
  }
}

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 tag 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 pattern:

Error: Invalid glob pattern: [invalid
Use standard glob patterns like "v1.*" or "v2.0.*"

Invalid latest value:

Error: latest must be a positive number
Usage: /repo:tag-list --latest <n>

</ERROR_HANDLING>

<NOTES> ## Tag Filtering

• Pattern matching: Uses glob patterns (*, ?, [abc], etc.)
• Latest N: Shows most recent tags by creation date
• Combine filters: Use both pattern and latest together

Use Cases

• Find release tags: --pattern "v*"
• Check recent releases: --latest 5
• Find specific version: --pattern "v1.2.*"
• Audit tags: list all without filters

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:tag-create - Create tags
• /repo:tag-push - Push tags to remote
• /repo:init - Configure repo plugin </NOTES>