Tools

Tools

This extension registers two tools that the agent can use autonomously.

ask_user_question

The agent calls this whenever it encounters ambiguity — questions and choices are generated dynamically based on context.

Parameter	Type	Description
question	string (required)	The question to ask the user
choices	string[] (optional)	Multiple choice options. "직접 입력하기" is auto-appended
placeholder	string (optional)	Placeholder hint for free-text input
defaultValue	string (optional)	Default value if user presses Enter

Modes:

• With choices → select menu, falling back to free-text input
• Without choices → free-text input

subagent

Delegates tasks to specialized agents running as separate pi CLI subprocesses.

Parameter	Type	Description
agent	string	Agent name (single mode)
task	string	Task description (single mode)
tasks	{agent, task}[]	Array for parallel mode (max 8)
chain	{agent, task}[]	Array for chain mode ({previous} placeholder)
agentScope	"user" | "project" | "both"	Agent search scope (default: "user")
cwd	string	Working directory
planFile	string	Path to plan file (required for plan-validator)
planTaskId	number	Task number in plan file (required for plan-validator)

Modes:

• Single — One-off task to a specific agent
• Parallel — Multiple agents dispatched concurrently (max 8 tasks, 4 concurrent)
• Chain — Sequential pipeline where each step receives previous output via {previous}

Safety:

• Cycle detection prevents infinite delegation loops
• Depth limit: max 3 levels
• Ancestor stack tracking