@vimsucks/pi-goon 0.3.0 → 0.3.1
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 +31 -29
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,38 +1,38 @@
|
|
|
1
1
|
# @vimsucks/pi-goon
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Resume the current Pi session with `/goon` without sending a new continuation prompt to the model.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Installation
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Requires Pi 1.0.0 or later.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Install from npm:
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
|
-
pi install
|
|
12
|
+
pi install npm:@vimsucks/pi-goon
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
Or install from GitHub:
|
|
16
16
|
|
|
17
17
|
```sh
|
|
18
|
-
pi install
|
|
18
|
+
pi install git:github.com/vimsucks/pi-goon
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
After installation, run `/reload` in the current session or restart Pi.
|
|
22
22
|
|
|
23
|
-
##
|
|
23
|
+
## Usage
|
|
24
24
|
|
|
25
|
-
- `/goon
|
|
26
|
-
- `/goon status
|
|
27
|
-
- `/goon help
|
|
25
|
+
- `/goon`: start an invisible continuation. If the agent is already running, Pi queues the continuation through its native follow-up queue.
|
|
26
|
+
- `/goon status`: show whether the session is idle and the text of the last assistant message.
|
|
27
|
+
- `/goon help`: show command help.
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
After a network request fails or you cancel generation, run `/goon` to resume the task in the same session. If Pi has exited, reopen the original session before running `/goon`.
|
|
30
30
|
|
|
31
|
-
##
|
|
31
|
+
## Keyboard shortcut
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
The default shortcut is `Alt+G`. It performs the same action as `/goon` without submitting or clearing text in the editor. Run `/hotkeys` to inspect the active shortcuts.
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
To change the shortcut, add a `goon` object to `~/.pi/agent/settings.json`. Keep the other settings in that file:
|
|
36
36
|
|
|
37
37
|
```json
|
|
38
38
|
{
|
|
@@ -42,32 +42,34 @@ pi install npm:@vimsucks/pi-goon
|
|
|
42
42
|
}
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
`goon.shortcut`
|
|
45
|
+
`goon.shortcut` accepts Pi key identifiers such as `alt+g`, `ctrl+alt+g`, or `f6`. Set it to `null` to disable the shortcut; `/goon` remains available. If the settings file or the `goon.shortcut` field is absent, the extension uses `alt+g`.
|
|
46
|
+
|
|
47
|
+
The extension no longer reads `goon.json`. If you have that file, move its `shortcut` value to `goon.shortcut` in `settings.json`.
|
|
46
48
|
|
|
47
|
-
|
|
49
|
+
If `PI_CODING_AGENT_DIR` is set, the extension reads `settings.json` from that directory. Only user-level settings apply; the extension does not read project settings.
|
|
48
50
|
|
|
49
|
-
|
|
51
|
+
After changing the configuration, run `/reload`. If the configuration is invalid, Pi reports a loading error. Correct the configuration and run `/reload` again.
|
|
50
52
|
|
|
51
|
-
|
|
53
|
+
Pi handles the shortcut through its native shortcut mechanism and applies its normal conflict rules. On macOS, configure the terminal to treat Option as Alt/Meta so it can send `Alt+G`. In Otty, open **Settings → Controls → Option as Alt** and select **Left** or **Both**. Otherwise, Option+G may insert `©` instead of triggering the shortcut.
|
|
52
54
|
|
|
53
|
-
##
|
|
55
|
+
## How it works and limitations
|
|
54
56
|
|
|
55
|
-
|
|
57
|
+
The extension uses `pi.sendMessage()` to add a hidden marker and start a native session turn. A `context` handler removes the marker before Pi sends a request to the model. The model receives no new `go on` prompt, and the marker is not displayed in the UI. The session journal still contains a hidden bookkeeping entry.
|
|
56
58
|
|
|
57
|
-
|
|
59
|
+
When a marker is present, the handler also removes trailing failed or aborted assistant messages from the request. It retains messages with tool calls to preserve tool-call/result pairs. It does not rewrite session history.
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
The extension does not resume automatically or guarantee continuation from the exact character where generation stopped. It preserves Pi's native queues, retries, and compaction behavior.
|
|
60
62
|
|
|
61
|
-
##
|
|
63
|
+
## Development check
|
|
62
64
|
|
|
63
|
-
|
|
65
|
+
Use Node.js 24 or later to run the offline check:
|
|
64
66
|
|
|
65
67
|
```sh
|
|
66
68
|
npm test
|
|
67
69
|
```
|
|
68
70
|
|
|
69
|
-
##
|
|
71
|
+
## Attribution and license
|
|
70
72
|
|
|
71
|
-
|
|
73
|
+
This project is based on npm version `0.3.16` of [monotykamary/pi-invisible-continue](https://github.com/monotykamary/pi-invisible-continue), authored by Tom X Nguyen and declared under the MIT license. It retains the invisible continuation and message-filtering logic, renames the command to `/goon`, and uses its own `pi-goon:resume` marker.
|
|
72
74
|
|
|
73
|
-
|
|
75
|
+
See [LICENSE](LICENSE).
|