Plan List Agents

List all agents in a plan with their status, features, and clickable links. Helps you find and select which specific agent to run.

Invocation

/plan-list-agents --plan <plan-name>

What This Command Does

1. Lists all agents - Shows all active agents in the plan (excludes completed/)
2. Shows agent information:
   • Agent number and display name
   • Features handled (#1, #2, #3)
   • Status summary (X PASS, Y WIP, Z GAP)
   • Clickable link to agent file
3. Shows how to run - Instructions for running a specific agent

Usage Examples

List Agents

/plan-list-agents --plan <plan-name>

This will:

• List all agents with status
• Show clickable links to agent files
• Display instructions for running specific agents

If no plan is specified, use list_plans MCP tool to see available plans first.

Instructions for Claude

When this command is invoked, you must:

1. List agents using MCP tool:

   • If --plan provided: Use list_agents MCP tool (server: limps) with the plan ID
   • Otherwise: Ask user which plan to list, or use list_plans MCP tool to show available plans

2. Display the output:

   • Show the formatted list of agents
   • Include agent numbers, names, features, and status
   • Show clickable file links
   • Display instructions for running specific agents

3. Provide guidance:

   • Explain how to use the agent file links
   • Reference /run-agent --agent [path] for running a specific agent
   • Show how to copy agent file path

When to Use

Use /plan-list-agents when:

• You want to see all available agents in a plan
• You want to choose which specific agent to run (not auto-select)
• You need to find an agent by name or features
• You want to see agent status at a glance

Use /run-agent <plan-name> instead when:

• You want to auto-select the next best agent
• You're ready to start working and don't care which agent

Use get_plan_status MCP tool instead when:

• You need detailed plan status
• You want to see completion percentages and blocked agents

Integration

This command helps you find agents, then use /run-agent --agent [agent-file-path] to run a specific one.

Workflow:

1. /plan-list-agents --plan <plan-name> - See all agents
2. Click agent file link or copy path
3. /run-agent --agent [agent-file-path] - Run the specific agent

Example Output

Agents in Plan: 0004-feature-name

Agent 0: Accessibility Foundation Early
  Features: #1, #2
  Status: 2 PASS, 0 WIP, 0 GAP
  File: plans/0004-feature-name/agents/000_agent_accessibility_foundation_early.agent.md

Agent 1: Column Display Features
  Features: #3, #4, #5
  Status: 0 PASS, 1 WIP, 2 GAP
  File: plans/0004-feature-name/agents/001_agent_column_display_features.agent.md

Agent 2: Status & Timing Columns
  Features: #6, #7
  Status: 0 PASS, 0 WIP, 2 GAP
  File: plans/0004-feature-name/agents/002_agent_status__timing_columns.agent.md

  (3 agent(s) in completed/ directory)

To run a specific agent:
   /run-agent --agent [agent-file-path]
   Or click the agent file link above

Notes

• Only shows active agents (excludes completed/ directory)
• Agent files are clickable and open directly in Cursor
• Agent file naming: NNN_agent_descriptive-name.agent.md (zero-padded 3-digit prefix)
• Status is parsed from agent file frontmatter
• Use this to find agents, then run with /run-agent --agent [path]