@pi-unipi/btw 0.1.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 +95 -0
- package/extensions/btw.ts +1972 -0
- package/package.json +49 -0
- package/skills/btw/SKILL.md +149 -0
package/README.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# @pi-unipi/btw
|
|
2
|
+
|
|
3
|
+
A [pi](https://github.com/badlogic/pi-mono) extension for parallel side conversations with `/btw` — part of the [Unipi](https://github.com/Neuron-Mr-White/unipi) suite.
|
|
4
|
+
|
|
5
|
+
`/btw` opens a real pi sub-session with coding-tool access, running immediately even while the main agent is still busy.
|
|
6
|
+
|
|
7
|
+
Based on [pi-btw](https://github.com/Neuron-Mr-White/pi-btw) by Dan Bachelder.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
As part of the full Unipi suite:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
pi install npm:unipi
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Standalone:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
pi install npm:@pi-unipi/btw
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Usage
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
/btw what file defines this route?
|
|
27
|
+
/btw how would you refactor this parser?
|
|
28
|
+
/btw --save summarize the last error in one sentence
|
|
29
|
+
/btw:new let's start a fresh thread about auth
|
|
30
|
+
/btw:tangent brainstorm from first principles without using the current chat context
|
|
31
|
+
/btw:inject implement the plan we just discussed
|
|
32
|
+
/btw:summarize turn that side thread into a short handoff
|
|
33
|
+
/btw:clear
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Commands
|
|
37
|
+
|
|
38
|
+
### /btw [--save] <question>
|
|
39
|
+
|
|
40
|
+
- runs right away, works while pi is busy
|
|
41
|
+
- creates or reuses a real BTW sub-session
|
|
42
|
+
- continues the current BTW thread
|
|
43
|
+
- opens a focused BTW modal shell
|
|
44
|
+
- streams into the BTW modal transcript/status surface
|
|
45
|
+
- persists the BTW exchange as hidden thread state
|
|
46
|
+
- with `--save`, also saves that single exchange as a visible session note
|
|
47
|
+
|
|
48
|
+
### /btw:new [question]
|
|
49
|
+
|
|
50
|
+
- clears the current BTW thread
|
|
51
|
+
- starts a fresh thread that still inherits the current main-session context
|
|
52
|
+
- optionally asks the first question in the new thread immediately
|
|
53
|
+
|
|
54
|
+
### /btw:tangent [--save] <question>
|
|
55
|
+
|
|
56
|
+
- starts or continues a contextless tangent thread
|
|
57
|
+
- does not inherit the current main-session conversation
|
|
58
|
+
- with `--save`, also saves that single exchange as a visible session note
|
|
59
|
+
|
|
60
|
+
### /btw:clear
|
|
61
|
+
|
|
62
|
+
- dismisses the BTW modal/widget
|
|
63
|
+
- clears the current BTW thread
|
|
64
|
+
|
|
65
|
+
### /btw:inject [instructions]
|
|
66
|
+
|
|
67
|
+
- sends the full BTW thread back to the main agent as a user message
|
|
68
|
+
- if pi is busy, queues it as a follow-up
|
|
69
|
+
- clears the BTW thread after sending
|
|
70
|
+
|
|
71
|
+
### /btw:summarize [instructions]
|
|
72
|
+
|
|
73
|
+
- summarizes the BTW thread with the current model
|
|
74
|
+
- injects the summary into the main agent
|
|
75
|
+
- clears the BTW thread after sending
|
|
76
|
+
|
|
77
|
+
## Overlay controls
|
|
78
|
+
|
|
79
|
+
- `Alt+/` toggles focus between BTW and the main editor without closing the overlay
|
|
80
|
+
- `Ctrl+Alt+W` is a fallback focus toggle for terminals that do not deliver `Alt+/` as a usable shortcut
|
|
81
|
+
- `Esc` still dismisses BTW immediately while the overlay is focused
|
|
82
|
+
- `PgUp`/`PgDn` scrolls the transcript
|
|
83
|
+
- BTW opens top-centered so the main session remains visible underneath
|
|
84
|
+
|
|
85
|
+
## Why
|
|
86
|
+
|
|
87
|
+
Sometimes you want to:
|
|
88
|
+
|
|
89
|
+
- ask a clarifying question while the main agent keeps working
|
|
90
|
+
- think through next steps without derailing the current turn
|
|
91
|
+
- explore an idea, then inject it back once it's ready
|
|
92
|
+
|
|
93
|
+
## License
|
|
94
|
+
|
|
95
|
+
MIT
|