pi-btw 0.4.1 → 0.5.0
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 +16 -4
- package/extensions/btw.ts +608 -110
- package/package.json +10 -5
- package/skills/btw/SKILL.md +170 -0
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ A small [pi](https://github.com/earendil-works/pi-mono) extension that adds a `/
|
|
|
13
13
|
- keeps a continuous BTW thread by default
|
|
14
14
|
- supports `/btw:tangent` for a contextless side thread that does not inherit the current main-session conversation
|
|
15
15
|
- opens a focused BTW modal shell with its own composer and transcript
|
|
16
|
-
- keeps the BTW overlay open while you switch focus back to the main editor with `Alt
|
|
16
|
+
- keeps the BTW overlay open while you switch focus back to the main editor with `Alt+/`, `Super+/`, or `Ctrl+Alt+W` (all remappable)
|
|
17
17
|
- keeps BTW thread entries out of the main agent's future context
|
|
18
18
|
- supports BTW-only model and thinking overrides without changing the main thread settings
|
|
19
19
|
- lets you inject the full thread, or a summary of it, back into the main agent
|
|
@@ -21,6 +21,8 @@ A small [pi](https://github.com/earendil-works/pi-mono) extension that adds a `/
|
|
|
21
21
|
|
|
22
22
|
## Install
|
|
23
23
|
|
|
24
|
+
pi-btw requires Pi 0.85.1 or newer.
|
|
25
|
+
|
|
24
26
|
### From npm (after publish)
|
|
25
27
|
|
|
26
28
|
```bash
|
|
@@ -70,14 +72,24 @@ pi install /absolute/path/to/pi-btw
|
|
|
70
72
|
- continues the current BTW thread
|
|
71
73
|
- opens or refreshes the focused BTW modal shell
|
|
72
74
|
- streams into the BTW modal transcript/status surface
|
|
75
|
+
- on RPC/SDK hosts, displays completed inline-question responses as visible session notes instead
|
|
76
|
+
- composer-only `/btw` requires the TUI; pass the question inline on RPC/SDK hosts
|
|
73
77
|
- persists the BTW exchange as hidden thread state
|
|
74
78
|
- with `--save`, also saves that single exchange as a visible session note
|
|
75
79
|
|
|
76
80
|
## Overlay controls
|
|
77
81
|
|
|
78
|
-
- `Alt
|
|
79
|
-
-
|
|
80
|
-
-
|
|
82
|
+
- `Alt+w` toggles the overlay between the framed window layout (inset from the terminal edges) and a full-width layout
|
|
83
|
+
- full-width mode makes terminal Shift+drag selection capture only the dialog's own text, which is handy for copying without pulling in surrounding main-screen content
|
|
84
|
+
- window mode keeps the full box frame; full-width mode drops the side borders and corner glyphs (keeping only horizontal rules) so those border columns never land inside a drag selection
|
|
85
|
+
- `Alt+/`, `Super+/`, or `Ctrl+Alt+W` toggles focus between BTW and the main editor without closing the overlay
|
|
86
|
+
- `Super+/` requires a terminal that reports the Super modifier, typically through the Kitty keyboard protocol
|
|
87
|
+
- `Ctrl+Alt+W` remains a fallback for terminals that do not deliver either primary shortcut
|
|
88
|
+
- set the `PI_BTW_FOCUS_KEYS` environment variable to remap these when they conflict with your window manager or terminal
|
|
89
|
+
- the value is a comma-separated list of pi-tui key identifiers such as `PI_BTW_FOCUS_KEYS="ctrl+/,ctrl+alt+b"`; it replaces the defaults entirely
|
|
90
|
+
- identifiers combine `ctrl`, `shift`, `alt`, and `super` with a single base key (letter, digit, symbol, or named key like `enter`/`f5`); blank or invalid entries are ignored, and the defaults are kept if none are usable
|
|
91
|
+
- while BTW is streaming, the first `Esc` aborts the request and keeps its partial transcript visible; press `Esc` again to dismiss
|
|
92
|
+
- while BTW is idle, `Esc` dismisses the overlay immediately
|
|
81
93
|
- BTW now opens top-centered so the main session remains visible underneath it
|
|
82
94
|
|
|
83
95
|
### `/btw:new [question]`
|