pi-qq 0.1.0 → 0.1.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 +36 -15
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -1,22 +1,33 @@
|
|
|
1
1
|
# pi-qq
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Ask quick side questions about your current [pi](https://pi.dev) session without polluting the main transcript.
|
|
4
|
+
|
|
5
|
+
`pi-qq` adds `/qq <question>` plus an **alt+q** / **Option+Q** shortcut that toggles `/qq ` in the editor. The answer appears ephemerally in a bottom overlay, using the current session as read-only context, and nothing is added to the main conversation.
|
|
6
|
+
|
|
7
|
+
## Why try it?
|
|
8
|
+
|
|
9
|
+
- **A real side channel:** ask `/qq why are we changing this file?` while the main agent keeps working. The answer shows in a bottom overlay and does not enter the main transcript.
|
|
10
|
+
- **Context-aware, intentionally constrained:** `/qq` passes a read-only clone of the main session, treats ambiguous references like “this”, “that”, “we”, and “the plan” as references to the active session, gives the side call no tools, and keeps no `/qq` history.
|
|
11
|
+
- **Fast, low-friction UX:** press **alt+q** / **Option+Q** to toggle `/qq `, submit your question, then use **Esc** to cancel/dismiss or **↑/↓** to scroll longer answers.
|
|
4
12
|
|
|
5
13
|
Do not install this alongside another package that registers `/qq`, because command names must be unique.
|
|
6
14
|
|
|
7
|
-
##
|
|
15
|
+
## Demo
|
|
8
16
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
- Uses a system prompt that assumes ambiguous questions are about the main session unless explicitly stated otherwise.
|
|
13
|
-
- Gives the quick-question side call no tools.
|
|
14
|
-
- Does **not** keep quick-question history. Each `/qq` call is independent except for the main-session context.
|
|
15
|
-
- Adds **alt+q** / **Option+Q** to toggle `/qq ` at the front of the editor.
|
|
17
|
+
```text
|
|
18
|
+
/qq why are we changing this file?
|
|
19
|
+
```
|
|
16
20
|
|
|
17
|
-
|
|
21
|
+
`pi-qq` answers from the active session context in a bottom overlay, without adding either the question or answer to your main conversation.
|
|
18
22
|
|
|
19
|
-
|
|
23
|
+
Another common flow:
|
|
24
|
+
|
|
25
|
+
1. Press **alt+q** / **Option+Q**.
|
|
26
|
+
2. Type `what's the risk with this plan?`.
|
|
27
|
+
3. Hit Enter.
|
|
28
|
+
4. Read the concise overlay answer; press **Esc** to dismiss.
|
|
29
|
+
|
|
30
|
+
## Install
|
|
20
31
|
|
|
21
32
|
```bash
|
|
22
33
|
pi install npm:pi-qq
|
|
@@ -26,24 +37,34 @@ After installing, run `/reload` in pi or restart the session.
|
|
|
26
37
|
|
|
27
38
|
## Usage
|
|
28
39
|
|
|
40
|
+
### Command
|
|
41
|
+
|
|
29
42
|
```text
|
|
30
|
-
/qq
|
|
43
|
+
/qq <question>
|
|
31
44
|
```
|
|
32
45
|
|
|
33
|
-
|
|
46
|
+
### Shortcut
|
|
34
47
|
|
|
35
|
-
|
|
48
|
+
Press **alt+q** / **Option+Q** to toggle `/qq ` at the front of the editor:
|
|
36
49
|
|
|
37
50
|
- If the editor does not start with `/qq `, the prefix is prepended.
|
|
38
51
|
- If the editor already starts with `/qq `, the prefix is removed.
|
|
39
52
|
|
|
40
|
-
|
|
53
|
+
### Overlay keys
|
|
41
54
|
|
|
42
55
|
| Key | Action |
|
|
43
56
|
| --- | --- |
|
|
44
57
|
| `↑` / `↓` | Scroll the panel when content overflows |
|
|
45
58
|
| `Esc` | Close the panel; cancel the request if it is still running |
|
|
46
59
|
|
|
60
|
+
## Design constraints
|
|
61
|
+
|
|
62
|
+
- The main transcript is never polluted by `/qq` questions or answers.
|
|
63
|
+
- The side call receives the current session as read-only context.
|
|
64
|
+
- The side call has no tools.
|
|
65
|
+
- `/qq` stores no quick-question history; each call is independent except for the main-session context.
|
|
66
|
+
- The system prompt biases answers toward concise, direct responses.
|
|
67
|
+
|
|
47
68
|
## License
|
|
48
69
|
|
|
49
70
|
MIT
|
package/package.json
CHANGED
|
@@ -1,11 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-qq",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Pi extension.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Pi extension. Ask context-aware side questions with /qq or alt+q without polluting the main transcript.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
7
7
|
"pi-extension",
|
|
8
8
|
"quick-question",
|
|
9
|
+
"side-question",
|
|
10
|
+
"context-aware",
|
|
11
|
+
"transcript-safe",
|
|
12
|
+
"no-history",
|
|
9
13
|
"question",
|
|
10
14
|
"shortcut",
|
|
11
15
|
"keybinding",
|