Agent Commands
Spawn, monitor, and control autonomous AI coding agents.
pan work issue
Spawn an agent for a Linear or GitHub issue.
This command:
- Creates a workspace (git worktree) if it doesn’t exist
- Spawns an autonomous agent in a tmux session
- The agent reads the issue, explores the codebase, and implements the solution
pan work status
List all running agents and their status.
Shows:
- Agent session ID
- Issue number and title
- Current status
- Runtime duration
- Workspace location
The dashboard’s Agents page is the visual counterpart to this command. A metric strip across the top tallies how many agents are running, how many are stuck, and the rolling cost and token spend over the last 24 hours, with each agent rendered as a card showing its model, runtime, and last activity.
Use pan work status from the terminal for a quick check, and the Agents page when you want to watch many agents at once and spot stuck ones at a glance.
pan work tell
Send a message to a running agent.
This command:
- Sends your message to the agent’s tmux session
- The agent receives it and responds accordingly
- Useful for providing feedback, clarification, or guidance
pan work kill
Stop a running agent.
Terminates the agent’s tmux session. The workspace and any uncommitted work remain intact.
pan work pending
Show work completed and awaiting review.
Lists issues where agents have finished work but haven’t been approved yet.
pan work approve
Approve agent work, merge MR, and update issue tracker.
This command:
- Spawns a merge-agent specialist
- Reviews the changes
- Merges the pull/merge request
- Updates the issue status
pan work list
List issues from configured trackers.
Shows issues from Linear, GitHub, or GitLab based on your configuration.
pan work triage
Triage issues from secondary tracker.
Process issues from a secondary tracker (e.g., Rally) and create equivalent issues in your primary tracker.
pan work reopen
Reopen a closed issue and re-run planning.
Reopens the issue in your tracker and restarts the planning session.
pan work request-review
Request re-review after fixing feedback.
For agents, this command has a maximum of 3 auto-requeues to prevent infinite loops.
pan work wipe
Deep wipe: completely reset all state for an issue.
This is a nuclear option that:
- Kills any running agents
- Cleans up state files
- Updates issue tracker status
- Optionally removes the workspace
pan work recover
Recover crashed agents.
Attempts to resume agents that crashed or were interrupted.
pan specialists
Manage specialist agents (review, test, inspect, UAT, merge).
See Specialist Agents for detailed information on each specialist type.
pan remote
Manage remote workspaces via Fly.io.
See Workspaces for details on remote workspace execution.
Next Steps
