@pi-unipi/btw 2.18.0 → 2.18.1

package/README.md

@@ -2,7 +2,7 @@
 
 Side conversations that run in parallel. Ask a question using `/unipi:btw` while the main agent keeps working — the answer streams into a modal overlay without interrupting the current task.
 
-BTW opens a real Pi sub-session with coding-tool access. Use it to clarify something, explore an idea, or think through next steps without derailing the main turn. When you're ready, inject the thread back or summarize it.
+BTW opens a real Pi sub-session with read-only file and search access. Use it to clarify something, explore an idea, or think through next steps without derailing the main turn. It cannot run commands or modify files; when you're ready, inject the thread back or summarize it.
 
 Based on [pi-btw](https://github.com/Neuron-Mr-White/pi-btw) by Dan Bachelder.
 
@@ -47,8 +47,8 @@ The BTW overlay opens top-centered so the main session remains visible underneat
 ## How It Works
 
 1. `/unipi:btw` creates or reuses a BTW sub-session
-2. Your question runs in a real Pi session with tool access
-3. The answer streams into the BTW modal overlay
+2. Your question runs in a real Pi session with read/search tool access (`read`, `grep`, `find`, `ls`)
+3. The read-only answer streams into the BTW modal overlay
 4. The thread continues until you clear it or inject it back
 
 `/unipi:btw-inject` sends the full thread to the main agent as a user message. If Pi is busy, it queues as a follow-up. `/unipi:btw-summarize` does the same but summarizes first.

package/extensions/btw.ts

@@ -2,7 +2,7 @@
  * @pi-unipi/btw — Side Conversation Extension
  *
  * A /unipi:btw side conversation channel that opens a real pi sub-session
- * with coding-tool access, running immediately even while the main
+ * with read-only coding-tool access, running immediately even while the main
  * agent is still busy.
  *
  * Based on pi-btw by Dan Bachelder, adapted for the Unipi suite.
@@ -64,6 +64,7 @@ const BTW_SYSTEM_PROMPT = [
   "If no main session messages are provided, treat this as a fully contextless tangent thread and rely only on the user's words plus your general instructions.",
   "Focus on answering the user's side questions, helping them think through ideas, or planning next steps.",
   "Do not act as if you need to continue unfinished work from the main session unless the user explicitly asks you to prepare something for injection back to it.",
+  "This aside is read-only: you can read and search files but cannot run commands or modify anything. Never claim to have edited, written, or executed something. If the user wants changes made, tell them to hand this thread off to the main session instead. Use /unipi:btw-inject or /unipi:btw-summarize to hand it off.",
 ].join(" ");
 
 const BTW_SUMMARIZE_SYSTEM_PROMPT =
@@ -1355,7 +1356,7 @@ export default function (pi: ExtensionAPI) {
       model: ctx.model,
       modelRuntime: sessionModelRuntime(ctx),
       thinkingLevel: pi.getThinkingLevel() as SessionThinkingLevel,
-      tools: ["read", "bash", "edit", "write"],
+      tools: ["read", "grep", "find", "ls"],
       resourceLoader: createBtwResourceLoader(ctx),
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.18.0",
+  "version": "2.18.1",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",

package/skills/btw/SKILL.md

@@ -7,6 +7,8 @@ description: Helps you use the /unipi:btw side-conversation workflow effectively
 
 Use this skill when the user wants to work in parallel with the main agent instead of derailing the current turn.
 
+BTW side sessions are read-only: they can read and search files with `read`, `grep`, `find`, and `ls`, but cannot run commands or modify files. Send requested changes to the main session with `/unipi:btw-inject` or `/unipi:btw-summarize`.
+
 ## When to use BTW
 
 Prefer the BTW workflow when the user wants to: