pi-subagents 0.5.1 → 0.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +33 -20
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [0.5.2] - 2026-01-28
|
|
6
|
+
|
|
7
|
+
### Improved
|
|
8
|
+
- **README: Added agent file locations** - New "Agents" section near top of README clearly documents:
|
|
9
|
+
- User agents: `~/.pi/agent/agents/{name}.md`
|
|
10
|
+
- Project agents: `.pi/agents/{name}.md` (searches up directory tree)
|
|
11
|
+
- `agentScope` parameter explanation (`"user"`, `"project"`, `"both"`)
|
|
12
|
+
- Complete frontmatter example with all fields
|
|
13
|
+
- Note about system prompt being the markdown body after frontmatter
|
|
14
|
+
|
|
5
15
|
## [0.5.1] - 2026-01-27
|
|
6
16
|
|
|
7
17
|
### Fixed
|
package/README.md
CHANGED
|
@@ -20,6 +20,39 @@ To remove:
|
|
|
20
20
|
npx pi-subagents --remove
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
+
## Agents
|
|
24
|
+
|
|
25
|
+
Agents are markdown files with YAML frontmatter that define specialized subagent configurations.
|
|
26
|
+
|
|
27
|
+
**Agent file locations:**
|
|
28
|
+
|
|
29
|
+
| Scope | Path |
|
|
30
|
+
|-------|------|
|
|
31
|
+
| User | `~/.pi/agent/agents/{name}.md` |
|
|
32
|
+
| Project | `.pi/agents/{name}.md` (searches up directory tree) |
|
|
33
|
+
|
|
34
|
+
Use `agentScope` parameter to control discovery: `"user"` (default), `"project"`, or `"both"` (project takes priority).
|
|
35
|
+
|
|
36
|
+
**Agent frontmatter:**
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
---
|
|
40
|
+
name: scout
|
|
41
|
+
description: Fast codebase recon
|
|
42
|
+
tools: read, grep, find, ls, bash
|
|
43
|
+
model: claude-haiku-4-5
|
|
44
|
+
skill: safe-bash, chrome-devtools # comma-separated skills to inject
|
|
45
|
+
output: context.md # writes to {chain_dir}/context.md
|
|
46
|
+
defaultReads: context.md # comma-separated files to read
|
|
47
|
+
defaultProgress: true # maintain progress.md
|
|
48
|
+
interactive: true # (parsed but not enforced in v1)
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
Your system prompt goes here (the markdown body after frontmatter).
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**Resolution priority:** step override > agent frontmatter > disabled
|
|
55
|
+
|
|
23
56
|
## Features (beyond base)
|
|
24
57
|
|
|
25
58
|
- **Skill Injection**: Agents declare skills in frontmatter; skills get injected into system prompts
|
|
@@ -99,26 +132,6 @@ Single and parallel modes also support the clarify TUI for previewing/editing pa
|
|
|
99
132
|
- `Home/End` - Start/end of current display line
|
|
100
133
|
- `Ctrl+Home/End` - Start/end of text
|
|
101
134
|
|
|
102
|
-
## Agent Frontmatter
|
|
103
|
-
|
|
104
|
-
Agents can declare default chain behavior in their frontmatter:
|
|
105
|
-
|
|
106
|
-
```yaml
|
|
107
|
-
---
|
|
108
|
-
name: scout
|
|
109
|
-
description: Fast codebase recon
|
|
110
|
-
tools: read, grep, find, ls, bash
|
|
111
|
-
model: claude-haiku-4-5
|
|
112
|
-
skill: safe-bash, chrome-devtools # comma-separated skills to inject
|
|
113
|
-
output: context.md # writes to {chain_dir}/context.md
|
|
114
|
-
defaultReads: context.md # comma-separated files to read
|
|
115
|
-
defaultProgress: true # maintain progress.md
|
|
116
|
-
interactive: true # (parsed but not enforced in v1)
|
|
117
|
-
---
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
**Resolution priority:** step override > agent frontmatter > disabled
|
|
121
|
-
|
|
122
135
|
## Skills
|
|
123
136
|
|
|
124
137
|
Skills are specialized instructions loaded from SKILL.md files and injected into the agent's system prompt.
|
package/package.json
CHANGED