@narumitw/pi-btw 0.1.9 → 0.1.10
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 +38 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,26 @@
|
|
|
1
|
-
# pi-btw
|
|
1
|
+
# 💬 pi-btw — Side Questions for the Pi Coding Agent
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/@narumitw/pi-btw) [](https://pi.dev) [](./LICENSE)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
`@narumitw/pi-btw` is a native [Pi coding agent](https://pi.dev) extension that adds `/btw`, a side-question command for quick clarifications that should not interrupt or pollute the main agent conversation.
|
|
6
|
+
|
|
7
|
+
Use it when you want to ask a temporary question, inspect context, or get a short explanation while keeping the primary coding task focused.
|
|
8
|
+
|
|
9
|
+
## ✨ Features
|
|
10
|
+
|
|
11
|
+
- Adds a `/btw <question>` command to Pi.
|
|
12
|
+
- Answers side questions in a temporary UI.
|
|
13
|
+
- Uses the current session branch as context.
|
|
14
|
+
- Does not append the side question or answer to the main conversation.
|
|
15
|
+
- Works as an independently installable npm Pi extension package.
|
|
16
|
+
|
|
17
|
+
## 📦 Install
|
|
6
18
|
|
|
7
19
|
```bash
|
|
8
20
|
pi install npm:@narumitw/pi-btw
|
|
9
21
|
```
|
|
10
22
|
|
|
11
|
-
Try without installing:
|
|
23
|
+
Try without installing permanently:
|
|
12
24
|
|
|
13
25
|
```bash
|
|
14
26
|
pi -e npm:@narumitw/pi-btw
|
|
@@ -20,15 +32,25 @@ Try this package locally from the repository root:
|
|
|
20
32
|
pi -e ./extensions/pi-btw
|
|
21
33
|
```
|
|
22
34
|
|
|
23
|
-
## Usage
|
|
35
|
+
## 🚀 Usage
|
|
24
36
|
|
|
25
37
|
```text
|
|
26
38
|
/btw <your side question>
|
|
27
39
|
```
|
|
28
40
|
|
|
29
|
-
|
|
41
|
+
Examples:
|
|
42
|
+
|
|
43
|
+
```text
|
|
44
|
+
/btw what does this TypeScript error mean?
|
|
45
|
+
/btw summarize the current implementation before we continue
|
|
46
|
+
/btw is this API name idiomatic?
|
|
47
|
+
```
|
|
30
48
|
|
|
31
|
-
##
|
|
49
|
+
## 🧠 Why use pi-btw?
|
|
50
|
+
|
|
51
|
+
Normal assistant messages become part of the main Pi conversation and can distract the coding agent from the task. `pi-btw` creates a lightweight side channel for context-aware questions, making it useful for pair programming, debugging, code review, and repository exploration.
|
|
52
|
+
|
|
53
|
+
## 🗂️ Package layout
|
|
32
54
|
|
|
33
55
|
```txt
|
|
34
56
|
extensions/pi-btw/
|
|
@@ -40,7 +62,7 @@ extensions/pi-btw/
|
|
|
40
62
|
└── package.json
|
|
41
63
|
```
|
|
42
64
|
|
|
43
|
-
The package exposes its extension through `package.json`:
|
|
65
|
+
The package exposes its Pi extension through `package.json`:
|
|
44
66
|
|
|
45
67
|
```json
|
|
46
68
|
{
|
|
@@ -49,3 +71,11 @@ The package exposes its extension through `package.json`:
|
|
|
49
71
|
}
|
|
50
72
|
}
|
|
51
73
|
```
|
|
74
|
+
|
|
75
|
+
## 🔎 Keywords
|
|
76
|
+
|
|
77
|
+
Pi extension, Pi coding agent, AI coding agent, side question command, agent chat workflow, TypeScript Pi package, npm Pi extension.
|
|
78
|
+
|
|
79
|
+
## 📄 License
|
|
80
|
+
|
|
81
|
+
MIT. See [`LICENSE`](./LICENSE).
|