@narumitw/pi-btw 0.60.2 → 0.61.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 +21 -4
- package/dist/index.ts +1685 -1029
- package/dist/index.ts.map +4 -4
- package/docs/workflows.md +10 -2
- package/package.json +1 -1
- package/src/btw.ts +43 -160
- package/src/conversation-context.ts +74 -0
- package/src/fullscreen-ui.ts +196 -7
- package/src/main-thread-updates.ts +40 -0
- package/src/menu.ts +34 -2
- package/src/settings.ts +49 -0
- package/src/side-thread.ts +40 -37
- package/src/transcript-pager.ts +9 -1
- package/src/workspace-layout.ts +559 -0
package/README.md
CHANGED
|
@@ -10,6 +10,7 @@ Only context you explicitly bring back is loaded into the main editor.
|
|
|
10
10
|
- Starts a side thread immediately with `/btw <question>` or opens the manager with `/btw`.
|
|
11
11
|
- Uses any persisted main-session branch as context without switching branches.
|
|
12
12
|
- Supports scrollable answers, transcript search, a clickable jump-to-latest control, follow-up questions, queued steering, and in-memory resume.
|
|
13
|
+
- Offers fullscreen, side-thread-left, and side-thread-right workspaces with Pi's live main-thread view, click-to-focus input, and a draggable remembered divider.
|
|
13
14
|
- Renders supported Mermaid fences as width-safe, themed Unicode diagrams without a browser or network request.
|
|
14
15
|
- Keeps side questions and answers out of the main conversation by default.
|
|
15
16
|
- Brings back the latest answer, a question suffix, an exact range, or the complete thread only when requested.
|
|
@@ -77,7 +78,9 @@ The normal location is `~/.pi/agent/pi-btw.json`.
|
|
|
77
78
|
"model": "anthropic/claude-sonnet-4-5",
|
|
78
79
|
"thinkingLevel": "low",
|
|
79
80
|
"rememberThinkingLevelChanges": true,
|
|
80
|
-
"fullscreenCopyOnSelect": true
|
|
81
|
+
"fullscreenCopyOnSelect": true,
|
|
82
|
+
"layout": "left-pane",
|
|
83
|
+
"sidePaneRatio": 0.5
|
|
81
84
|
}
|
|
82
85
|
```
|
|
83
86
|
|
|
@@ -106,10 +109,23 @@ When **Same as main thread** is selected, shortcut changes stay local even when
|
|
|
106
109
|
If a shortcut write fails, the local change remains active and pi-btw warns that it was not remembered.
|
|
107
110
|
A failed Settings-screen save instead restores the previous displayed value.
|
|
108
111
|
|
|
109
|
-
`fullscreenCopyOnSelect` controls only pi-btw's dedicated
|
|
112
|
+
`fullscreenCopyOnSelect` controls only pi-btw's dedicated workspace and defaults to `true` when omitted.
|
|
110
113
|
Turn **Copy selection automatically** off to retain highlighted selections and copy them with Pi's effective `app.message.copy` binding.
|
|
111
114
|
Pi-btw does not inherit Pi core's setting of the same name because Pi's public extension API does not expose its effective value.
|
|
112
115
|
|
|
116
|
+
`layout` controls the dedicated workspace and defaults to `fullscreen` when omitted.
|
|
117
|
+
Accepted values are `fullscreen`, `left-pane`, and `right-pane`.
|
|
118
|
+
The pane names identify the side thread's position; the other pane reuses Pi's native main-thread rendering at pane width and stays current while BTW is open.
|
|
119
|
+
A single muted divider separates the panes; click either pane to move keyboard focus to it.
|
|
120
|
+
Drag the divider with the primary mouse button to resize both panes.
|
|
121
|
+
The side-thread share is limited to 20–80% and saved as `sidePaneRatio` when the button is released, independent of whether the side thread is on the left or right.
|
|
122
|
+
If the save fails, the workspace restores the last saved ratio and reports the error.
|
|
123
|
+
Pi's search and keyboard viewport controls apply to the active pane.
|
|
124
|
+
The mouse wheel scrolls the pane under the pointer without moving keyboard focus, and both panes continue redrawing while either pane is active.
|
|
125
|
+
If you selected context from the main-thread tree, the main pane still shows the active main thread while the side model receives the selected branch.
|
|
126
|
+
Pane layouts collapse to the side thread alone below 80 terminal columns and return keyboard focus to it.
|
|
127
|
+
Choose **Side-thread layout** in Settings; changes apply the next time a new or resumed BTW workspace opens.
|
|
128
|
+
|
|
113
129
|
### Keybindings
|
|
114
130
|
|
|
115
131
|
Open `/btw` → **Settings**, select a shortcut row, then choose **Edit key combination…** or **Restore default**.
|
|
@@ -149,9 +165,9 @@ An explicitly unbound Pi thinking action stays unbound. Remove an override field
|
|
|
149
165
|
### Persistence
|
|
150
166
|
|
|
151
167
|
Reading a missing settings file has no side effects.
|
|
152
|
-
Pi-btw creates it only after a Settings change
|
|
168
|
+
Pi-btw creates it only after a Settings change, a remembered shortcut change, or a divider drag.
|
|
153
169
|
Within one Pi process, saves run in order and publish atomically through a same-directory temporary file and rename.
|
|
154
|
-
Saves preserve
|
|
170
|
+
Saves preserve other recognized settings and unknown fields.
|
|
155
171
|
Malformed or invalid files block saves and remain unchanged.
|
|
156
172
|
Files must be valid UTF-8 and no larger than 64 KiB.
|
|
157
173
|
Separate Pi processes and external editors are outside the in-process ordering boundary.
|
|
@@ -160,6 +176,7 @@ The file is read for every `/btw` invocation, so edits apply without `/reload`.
|
|
|
160
176
|
## 🚧 Limitations
|
|
161
177
|
|
|
162
178
|
- `/btw` supports TUI mode only.
|
|
179
|
+
- Only the clicked pane receives keyboard input; hovering or scrolling over the other pane does not move focus.
|
|
163
180
|
- Resume state is memory-only and lasts only for the current extension instance.
|
|
164
181
|
- A side thread retains the latest 40,000 characters of main-conversation context and adds a truncation notice when earlier content is omitted.
|
|
165
182
|
- Clipboard access depends on Pi's host helper, the operating system, and the terminal.
|