1---
 2name: invoking-subagents
 3description: Spawns subagents with configurable tool access that return just the answers without flooding your context. Use for summarizing extensive git history, comparing across multiple repositories in parallel, or processing large diffs/logs.
 4compatibility: Requires `synu` shell plugin and `claude` CLI tool
 5license: GPL-3.0-or-later
 6metadata:
 7  author: Amolith <amolith@secluded.site>
 8---
 9
10Invoke with `PI_PERMISSION_LEVEL=level pi -p 'prompt'`. DO NOT impose a timeout. Set a different model, if requested, with `pi --model "provider/model" -p "prompt"`.
11
12**Important:** Subagents are scoped to their cwd. To invoke a subagent in another folder, `cd there && PI_PERMISSION_LEVEL=level pi ...`.
13
14Use a precise and thorough prompt. You may invoke multiple when appropriate and in parallel if helpful. Once they're running, you may either stop and wait for me to tell you they're finished or continue with other work. Aggressively restrict their permissions:
15
16- minimal: read-only commands such as ls, cat, git status, etc.
17- low: + write/edit files
18- medium: + npm, git, make, cargo, etc.
19- high: everything (though particular dangerous commands are still disallowed)
20
21Example exploring git history in another repo:
22
23```bash
24cd /path/to/other/repo && PI_PERMISSION_LEVEL=minimal pi -p 'Using only git log and git show, summarise the major user-facing changes in HASH..HASH. Do not provide code snippets or technical details. Consider user-facing changes, like being able to set a port-out PIN or adding a new button or changing font sizes.'"
25```