pi-acp 0.0.16 → 0.0.17
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/README.md +10 -22
- package/dist/index.js +49 -810
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ ACP ([Agent Client Protocol](https://agentclientprotocol.com/overview/introducti
|
|
|
6
6
|
|
|
7
7
|
## Status
|
|
8
8
|
|
|
9
|
-
This is an MVP-style adapter intended to be useful today and easy to iterate on.
|
|
9
|
+
This is an MVP-style adapter intended to be useful today and easy to iterate on. Some ACP features may be not implemented or are not supported (see [Limitations](#limitations)). Development is centered around Zed editor support, other clients may have varying levels of compatibility.
|
|
10
10
|
|
|
11
11
|
## How it works
|
|
12
12
|
|
|
@@ -33,6 +33,8 @@ High-level mapping:
|
|
|
33
33
|
- Adds a small set of built-in commands for headless/editor usage
|
|
34
34
|
- Skills are loaded by pi directly and are available in ACP sessions
|
|
35
35
|
- (Zed) On session start, `pi-acp` posts a markdown “startup info” block (pi version, context file, skills, prompts, extensions)
|
|
36
|
+
- (Zed) By default, `pi-acp` emits a short markdown “startup info” block into the session (pi version, context, skills, prompts, extensions - similar to `pi` in the terminal). You can disable it by setting: `PI_ACP_STARTUP_INFO=false` (see below)
|
|
37
|
+
- (Zed) Session history is supported in Zed starting with [`v0.225.0`](https://zed.dev/releases/preview/0.225.0). Session loading / history maps to pi's session files. Sessions can be resumed both in `pi` and in the ACP client.
|
|
36
38
|
|
|
37
39
|
## Prerequisites
|
|
38
40
|
|
|
@@ -52,7 +54,7 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
52
54
|
|
|
53
55
|
Add the following to your Zed `settngs.json`:
|
|
54
56
|
|
|
55
|
-
#### Using with `npx` (no global install needed):
|
|
57
|
+
#### Using with `npx` (no global install needed, always loads the latest version):
|
|
56
58
|
|
|
57
59
|
```json
|
|
58
60
|
"agent_servers": {
|
|
@@ -104,24 +106,6 @@ Point your ACP client to the built `dist/index.js`:
|
|
|
104
106
|
}
|
|
105
107
|
```
|
|
106
108
|
|
|
107
|
-
## Features
|
|
108
|
-
|
|
109
|
-
### Startup info message (Zed)
|
|
110
|
-
|
|
111
|
-
By default, `pi-acp` emits a short markdown “startup info” block into the session (pi version, context, skills, prompts, extensions).
|
|
112
|
-
|
|
113
|
-
Disable it by setting:
|
|
114
|
-
|
|
115
|
-
- `PI_ACP_STARTUP_INFO=false`
|
|
116
|
-
|
|
117
|
-
In Zed:
|
|
118
|
-
|
|
119
|
-
```json
|
|
120
|
-
"env": {
|
|
121
|
-
"PI_ACP_STARTUP_INFO": "false"
|
|
122
|
-
}
|
|
123
|
-
```
|
|
124
|
-
|
|
125
109
|
### Slash commands
|
|
126
110
|
|
|
127
111
|
`pi-acp` supports slash commands:
|
|
@@ -152,7 +136,11 @@ Other built-in commands:
|
|
|
152
136
|
- `/thinking` - maps to 'mode' selector in Zed
|
|
153
137
|
- `/clear` - not implemented (use ACP client 'new' command)
|
|
154
138
|
|
|
155
|
-
|
|
139
|
+
#### 3) Skill commands
|
|
140
|
+
|
|
141
|
+
- Skill commands can be enabled in pi settings and will appear in the slash command list in ACP host as `/skill:skill-name`.
|
|
142
|
+
|
|
143
|
+
**Note**: Slash commands provided by pi extensions are not currently supported.
|
|
156
144
|
|
|
157
145
|
## Authentication / Setup (ACP Registry)
|
|
158
146
|
|
|
@@ -189,7 +177,7 @@ Project layout:
|
|
|
189
177
|
- MCP servers are accepted in ACP params and stored in session state, but not wired through to pi.
|
|
190
178
|
- Assistant streaming is currently sent as `agent_message_chunk` (no separate thought stream).
|
|
191
179
|
- Queue is implemented client-side and should work like pi's `one-at-a-time`
|
|
192
|
-
- ACP clients don't yet suport session history, but ACP sessions from `pi-acp` can be `/resume`d in pi directly
|
|
180
|
+
- ~~ACP clients don't yet suport session history, but ACP sessions from `pi-acp` can be `/resume`d in pi directly~~
|
|
193
181
|
|
|
194
182
|
## License
|
|
195
183
|
|