[Sync] llm stuff

common/.pi/README.md

@@ -63,11 +63,16 @@ have a slash command to disable them for the current session without deleting.
 | `permission-gate.ts` | Prompts before dangerous `bash` commands (blocks outright with no UI). Local list covers git history rewrites, package managers, `systemctl` and irreversible disk ops on top of upstream's `rm -rf`/`sudo`/`chmod 777` | **adapted** from pi's `examples/extensions/permission-gate.ts` | delete file |
 | `protected-paths.ts` | Blocks `write`/`edit` to secrets and repo plumbing (`secrets.fish`, `auth.json`, `.env`, `.ssh/`, `.git/`, …) | **adapted** from pi's `examples/extensions/protected-paths.ts` | delete file |
 | `compaction-watch.ts` | Surfaces every compaction and its `reason`; loudly flags `overflow` (recovery rather than prevention), which means `reserveTokens` is below the model's `maxTokens` | **custom** | delete file |
+| `verbose.ts` | `/verbose [on|off|status]` and **Alt+V** toggle the *persisted* verbose default (`hideThinkingBlock`, `showCacheMissNotices`) and report pi's live keys — `ctrl+o` tool output, `ctrl+t` thinking, which an extension cannot drive itself | **custom** | delete file; the live keys are built in and keep working |
 | `confirm-destructive.ts` | Confirms before session clear / switch / fork | **verbatim** from pi's `examples/extensions/confirm-destructive.ts` | delete file |
 | `session-name.ts` | `/session-name [name]` — friendly names in the session picker instead of the first message | **verbatim** from pi's `examples/extensions/session-name.ts` | delete file |
 | `todo.ts` | A `todo` tool the model calls (add/toggle/list/clear) plus `/todos` to view it; state lives in tool results, so forking rewinds it correctly. Distinct from plan-mode's checklist | **verbatim** from pi's `examples/extensions/todo.ts` | delete file (it also adds a tool schema to every request) |
 
-> The bundled examples live at `/opt/pi-coding-agent/examples/extensions/` — that's
+> The bundled examples live under pi's install prefix, which moves: it was
+> `/opt/pi-coding-agent/` before 0.85 and is `/usr/lib/pi-coding-agent/` on current Arch
+> packages. Rather than hardcode either, resolve it —
+> `set -l PI_ROOT (dirname (readlink -f (which pi)))` — and read `$PI_ROOT/examples/extensions/`.
+> That's
 > where `notify`/`questionnaire`/`plan-mode` came from. `plan-mode/` is now the only
 > **fork** left, so it's the only one to re-pull after a pi upgrade before re-applying
 > the local edits (its header documents them). `notify`/`questionnaire` carry no edits
@@ -103,7 +108,8 @@ pi install npm:pi-vim
 >
 > ```fish
 > cd ~/.pi/agent/npm
-> fnm exec --using=22 -- npm install --save-exact @earendil-works/pi-coding-agent@0.83.0
+> fnm exec --using=22 -- npm install --save-exact \
+> "@earendil-works/pi-coding-agent@"(pi --version | string trim)
 > ```
 >
 > `pi install` deliberately doesn't pull peers (it would duplicate the runtime). Costs
@@ -142,11 +148,11 @@ working diff). Both are **custom**. Format is YAML frontmatter + body with
 
 `keybindings.json` overrides three actions. **A user entry replaces the default keys
 for that action — it does not merge.** Action ids and their stock defaults are in
-`/opt/pi-coding-agent/docs/keybindings.md`.
+`$PI_ROOT/docs/keybindings.md` (see above for `$PI_ROOT`).
 
 ```jsonc
 {
-  "app.thinking.cycle":   ["ctrl+shift+t"], // moved OFF Shift+Tab so plan-mode can bind it
+  "app.thinking.cycle":   ["alt+t"], // moved OFF Shift+Tab so plan-mode can bind it (was ctrl+shift+t = kitty new_tab, never reached pi)
   "tui.editor.cursorUp":  ["up", "ctrl+p"], // adds Ctrl+P as up (Emacs-style)
   "app.model.cycleForward": ["alt+p"]       // Alt+P cycles models
 }