pi-qq 0.1.0 → 0.1.2

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.
Files changed (2) hide show
  1. package/README.md +35 -16
  2. package/package.json +6 -2
package/README.md CHANGED
@@ -1,22 +1,31 @@
1
1
  # pi-qq
2
2
 
3
- A [pi](https://pi.dev) package that provides a self-contained `/qq` command for quick questions about the **main pi session**, plus an **alt+q** / **Option+Q** shortcut that toggles the `/qq ` prefix in the editor.
3
+ Ask quick side questions about your current [pi](https://pi.dev) session without polluting the main transcript.
4
4
 
5
- Do not install this alongside another package that registers `/qq`, because command names must be unique.
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
6
 
7
- ## What it does
7
+ ## Why try it?
8
8
 
9
- - Adds `/qq <question>`.
10
- - Sends the active model a read-only clone of the main session as context.
11
- - Shows the answer in a bottom overlay, without adding anything to the main transcript.
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.
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.
16
12
 
17
- ## Install
13
+ ## Demo
14
+
15
+ ```text
16
+ /qq why are we changing this file?
17
+ ```
18
+
19
+ `pi-qq` answers from the active session context in a bottom overlay, without adding either the question or answer to your main conversation.
20
+
21
+ Another common flow:
18
22
 
19
- Install this package:
23
+ 1. Press **alt+q** / **Option+Q**.
24
+ 2. Type `what's the risk with this plan?`.
25
+ 3. Hit Enter.
26
+ 4. Read the concise overlay answer; press **Esc** to dismiss.
27
+
28
+ ## Install
20
29
 
21
30
  ```bash
22
31
  pi install npm:pi-qq
@@ -26,24 +35,34 @@ After installing, run `/reload` in pi or restart the session.
26
35
 
27
36
  ## Usage
28
37
 
38
+ ### Command
39
+
29
40
  ```text
30
- /qq why are we changing this file?
41
+ /qq <question>
31
42
  ```
32
43
 
33
- Or press **alt+q** / **Option+Q**, type your quick question, and hit enter.
44
+ ### Shortcut
34
45
 
35
- Pressing **alt+q** / **Option+Q** toggles the prefix:
46
+ Press **alt+q** / **Option+Q** to toggle `/qq ` at the front of the editor:
36
47
 
37
48
  - If the editor does not start with `/qq `, the prefix is prepended.
38
49
  - If the editor already starts with `/qq `, the prefix is removed.
39
50
 
40
- ## Overlay keys
51
+ ### Overlay keys
41
52
 
42
53
  | Key | Action |
43
54
  | --- | --- |
44
55
  | `↑` / `↓` | Scroll the panel when content overflows |
45
56
  | `Esc` | Close the panel; cancel the request if it is still running |
46
57
 
58
+ ## Design constraints
59
+
60
+ - The main transcript is never polluted by `/qq` questions or answers.
61
+ - The side call receives the current session as read-only context.
62
+ - The side call has no tools.
63
+ - `/qq` stores no quick-question history; each call is independent except for the main-session context.
64
+ - The system prompt biases answers toward concise, direct responses.
65
+
47
66
  ## License
48
67
 
49
68
  MIT
package/package.json CHANGED
@@ -1,11 +1,15 @@
1
1
  {
2
2
  "name": "pi-qq",
3
- "version": "0.1.0",
4
- "description": "Pi extension. Adds /qq for one-off quick questions about the main session, plus an alt+q shortcut to toggle the /qq prefix.",
3
+ "version": "0.1.2",
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",