demo-subagents-tui

Demo: Subagents in pi-go TUI

This skill demonstrates how to use the agent tool to spawn subagents within the pi-go TUI for parallel task execution. Subagents are autonomous child processes that run concurrently, enabling efficient parallelization of independent tasks.

Overview

The subagent system allows the main agent to spawn child agents that execute tasks independently. Each subagent:

• Runs as a separate pi subprocess
• Receives its own prompt and context
• Streams events back to the TUI for live display
• Returns a final result upon completion

Available agent types:

Type	Role	Worktree	Best For
explore	smol	No	Fast, read-only codebase exploration
plan	plan	No	Analysis and implementation planning
task	default	Yes	Full coding tasks with code changes
designer	slow	Yes	Code creation and modification
reviewer	slow	No	Code review with git inspection
quick-task	smol	No	Small, focused tasks

Limitations:

• Maximum 8 concurrent subagents at a time (pool size: 5)
• Subagents run in isolated git worktrees for task, designer types
• Worktrees are automatically cleaned up after completion

---

Three Execution Modes

The subagent tool supports three execution modes:

Single Mode

Spawn one agent to perform a specific task.

{
  "agent": "explore",
  "task": "Find all test files in the project and identify testing patterns used."
}

Parallel Mode

Spawn multiple agents concurrently (max 8) to work on independent tasks simultaneously.

{
  "tasks": [
    {"agent": "explore", "task": "Find all error handling patterns in internal/tools/"},
    {"agent": "reviewer", "task": "Review the session package for code quality issues"},
    {"agent": "quick-task", "task": "Run go vet on internal/agent/ and report issues"}
  ]
}

Chain Mode

Run agents sequentially, passing each result to the next step.

{
  "chain": [
    {"agent": "explore", "task": "Find the main entry point and session management code"},
    {"agent": "plan", "task": "Based on this: {previous}\nSuggest a refactoring plan for the session package"},
    {"agent": "task", "task": "Implement the refactoring plan: {previous}"}
  ]
}