@kushalkhemka/opensec-pi-subagents 0.19.5 → 0.19.6
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 +5 -0
- package/README.md +75 -19
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.19.6] - 2026-10-03
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
- Docs: README restyle (logo, install for Node and Bun). No code changes.
|
|
14
|
+
|
|
10
15
|
## [0.19.5] - 2026-10-03
|
|
11
16
|
|
|
12
17
|
### Fixed
|
package/README.md
CHANGED
|
@@ -1,8 +1,41 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://pi-bolt.opensec.in/plugins/opensec-pi-subagents.svg" width="96" height="96" alt="Subagents for Pi logo">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<h1 align="center">Subagents for Pi</h1>
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
<p align="center">Run specialized Pi agents in separate sessions, inheriting the parent's model and thinking level, with cached agent discovery.</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<img alt="Pi extension" src="https://img.shields.io/badge/Pi-extension-2A78D6?style=flat-square">
|
|
11
|
+
<img alt="Node build: latest" src="https://img.shields.io/badge/node-latest-4C96EA?style=flat-square&logo=nodedotjs&logoColor=white">
|
|
12
|
+
<img alt="Bun build: @bun" src="https://img.shields.io/badge/bun-%40bun-F7C04A?style=flat-square&logo=bun&logoColor=black">
|
|
13
|
+
<img alt="License" src="https://img.shields.io/badge/license-MIT-555?style=flat-square">
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
## Install
|
|
17
|
+
|
|
18
|
+
| Runtime | Command |
|
|
19
|
+
|---|---|
|
|
20
|
+
| **Pi on Node** (`latest`) | `pi install npm:@kushalkhemka/opensec-pi-subagents` |
|
|
21
|
+
| **pi-bolt / Pi on Bun** (`bun`) | `pi install npm:@kushalkhemka/opensec-pi-subagents@bun` |
|
|
22
|
+
|
|
23
|
+
> Pick the one that matches the Pi you run: `pi-bolt` (or Pi started with Bun) → `@bun`; Pi on Node → the plain name.
|
|
24
|
+
> The builds are maintained per runtime and can differ in details (the Bun README lists what differs). These are private packages: log in to npm with an account that can read
|
|
25
|
+
> `@kushalkhemka` first (`npm login`), or put a read token in `~/.npmrc`.
|
|
26
|
+
|
|
27
|
+
Restart Pi or run `/reload` after installing. Update with `pi update --extensions`; remove with
|
|
28
|
+
`pi remove npm:@kushalkhemka/opensec-pi-subagents`.
|
|
29
|
+
|
|
30
|
+
### Requirements
|
|
31
|
+
|
|
32
|
+
- Pi 0.84.0 or newer.
|
|
33
|
+
- Install only one Subagents package at a time: the public and private packages expose the same tools.
|
|
34
|
+
|
|
35
|
+
## Features
|
|
36
|
+
|
|
37
|
+
This maintained fork of `@tintinweb/pi-subagents` runs specialized Pi agents in separate sessions while the main agent
|
|
38
|
+
continues working, and adds parent model and thinking-level inheritance and cached agent discovery.
|
|
6
39
|
|
|
7
40
|
- Background agents by default, with optional foreground runs, steering, result retrieval, and session resume.
|
|
8
41
|
- Built-in `Explore` and `Plan` agents for read-only work, plus a general-purpose agent and custom agent definitions.
|
|
@@ -10,31 +43,54 @@ Run specialized Pi agents in separate sessions while the main agent continues wo
|
|
|
10
43
|
- An `/agents` UI for live conversations, settings, workflows, and scheduled jobs.
|
|
11
44
|
- Optional nested delegation, persistent memory, skill preloading, and Git worktree isolation.
|
|
12
45
|
|
|
13
|
-
##
|
|
46
|
+
## Usage
|
|
14
47
|
|
|
15
|
-
|
|
48
|
+
Ask Pi to delegate work, for example: “Use an Explore agent to find the authentication code, then report the relevant
|
|
49
|
+
files.” Pi can call the `Agent` tool like this:
|
|
16
50
|
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
pi install npm:@kushalkhemka/opensec-pi-subagents
|
|
51
|
+
```text
|
|
52
|
+
Agent({ subagent_type: "Explore", prompt: "Find authentication code", description: "Find auth files" })
|
|
20
53
|
```
|
|
21
54
|
|
|
22
|
-
|
|
55
|
+
### Tools
|
|
23
56
|
|
|
24
|
-
|
|
57
|
+
| Tool | What it does |
|
|
58
|
+
|---|---|
|
|
59
|
+
| `Agent` | Starts an agent. A background run returns an ID and notifies the main session when it finishes; set `run_in_background: false` when the next step must wait for its result. Also accepts session-scoped cron, interval, and one-shot schedules. |
|
|
60
|
+
| `get_subagent_result` | Returns the full result of an agent. |
|
|
61
|
+
| `steer_subagent` | Redirects a running agent. |
|
|
62
|
+
| `SubagentWorkflow` | Runs repeatable multi-agent work (`agent()`, `parallel()`, `pipeline()`). |
|
|
25
63
|
|
|
26
|
-
|
|
64
|
+
### Commands
|
|
27
65
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
66
|
+
| Command | What it does |
|
|
67
|
+
|---|---|
|
|
68
|
+
| `/agents` | Inspect and manage agents: live conversations, settings, workflows, and scheduled jobs (`/agents → Scheduled jobs`). |
|
|
69
|
+
| `@<agent> <message>` | With agent mentions enabled, sends a message to that agent, e.g. `@explore check the RPC path`. A finished agent can be resumed. |
|
|
70
|
+
|
|
71
|
+
### Custom agents
|
|
72
|
+
|
|
73
|
+
Put custom definitions in `.pi/agents/<name>.md` or the global Pi agents directory. Agents inherit the current parent's
|
|
74
|
+
model and thinking level unless their definition or call overrides them.
|
|
75
|
+
|
|
76
|
+
## Configuration
|
|
77
|
+
|
|
78
|
+
| Setting | Default | Meaning |
|
|
79
|
+
|---|---|---|
|
|
80
|
+
| Background concurrency (`/agents → Settings`) | `10` | How many background agents run at once. |
|
|
81
|
+
|
|
82
|
+
## Notes
|
|
31
83
|
|
|
32
|
-
|
|
84
|
+
- Schedules: interval schedules must be at least `1m` (stored shorter intervals are raised to one minute); intervals and
|
|
85
|
+
relative delays are capped at `3650d`.
|
|
86
|
+
- Worktree isolation is optional and commits an isolated agent's changes to its branch on completion.
|
|
87
|
+
- Review `/agents → Settings` before enabling delegation or isolation for write-capable agents.
|
|
33
88
|
|
|
34
|
-
|
|
89
|
+
## Security
|
|
35
90
|
|
|
36
|
-
|
|
91
|
+
Workflow scripts run in a vm that is a determinism and accident boundary, not a defence against a deliberately hostile
|
|
92
|
+
script; see [`docs/workflows.md`](docs/workflows.md).
|
|
37
93
|
|
|
38
|
-
|
|
94
|
+
## License
|
|
39
95
|
|
|
40
|
-
MIT
|
|
96
|
+
MIT. Based on `@tintinweb/pi-subagents` by tintinweb.
|
package/package.json
CHANGED