@diegopetrucci/pi-extensions 0.1.16 → 0.1.18

package/README.md

@@ -2,13 +2,14 @@
 
 A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions I made:
 
+- [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
+- [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi avoids the `dumb zone`; toggle temporarily with `/context-cap`.
+- [`librarian`](./extensions/librarian): Adds a GitHub research scout that asks whether to use an opt-in local repo checkout cache under the OS user cache directory, with cached repos expiring after 30 days of non-use.
 - [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional `DUMB ZONE`, plus OpenAI Codex 5-hour and 7-day usage when available.
+- [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
 - [`oracle`](./extensions/oracle): Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, covers pi’s built-in providers with hardcoded rankings, sets reasoning to xhigh by default, and shows live status while running.
-- [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi avoids the `dumb zone`; toggle temporarily with `/context-cap`.
-- [`compact-bash`](./extensions/compact-bash): Renders collapsed assistant `bash` tool output as a one-line preview; toggle temporarily with `/compact-bash`.
 - [`permission-gate`](./extensions/permission-gate): Prompts for confirmation before dangerous bash commands like `rm -rf`, `sudo`, and `chmod 777`.
-- [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
-- [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
+- [`quiet-tools`](./extensions/quiet-tools): Renders collapsed built-in tool rows as quiet one-line previews without changing model-visible tool results; toggle temporarily with `/quiet-tools`.
 
 (For the full list of pi extensions I use, [check out my dotfiles](https://github.com/diegopetrucci/dot/blob/main/.pi/agent/settings.json).)
 
@@ -23,13 +24,13 @@ pi install npm:@diegopetrucci/pi-extensions
 Or pin the GitHub package to this release:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions@v0.1.16
+pi install git:github.com/diegopetrucci/pi-extensions@v0.1.18
 ```
 
 Or a specific extension:
 
 ```bash
-pi install npm:@diegopetrucci/pi-oracle
+pi install npm:@diegopetrucci/pi-quiet-tools
 ```
 
 Then reload pi:

package/extensions/librarian/README.md

@@ -0,0 +1,76 @@
+# librarian
+
+A pi GitHub research scout inspired by `pi-librarian`, with an opt-in local checkout cache.
+
+When the `librarian` tool runs, it asks whether to cache/reuse repository checkouts locally. If you say no, cancel, time out, or run without UI, it uses GitHub API/search and temporary fetched files only.
+
+## Install
+
+### Standalone npm package
+
+```bash
+pi install npm:@diegopetrucci/pi-librarian
+```
+
+### Collection package
+
+```bash
+pi install npm:@diegopetrucci/pi-extensions
+```
+
+### GitHub package
+
+```bash
+pi install git:github.com/diegopetrucci/pi-extensions
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## Behavior
+
+- Tool name: `librarian`
+- Uses a restricted subagent with `bash` and `read`
+- Uses `gh` for GitHub search/API access
+- Asks on each call whether to use cached local checkouts
+- Defaults to no checkout/cache
+- Cached repos are removed lazily after 30 days without use
+
+## Cache location
+
+macOS:
+
+```text
+~/Library/Caches/pi-librarian/repos/github.com/<owner>/<repo>
+```
+
+Linux:
+
+```text
+${XDG_CACHE_HOME:-~/.cache}/pi-librarian/repos/github.com/<owner>/<repo>
+```
+
+Windows:
+
+```text
+%LOCALAPPDATA%\pi-librarian\repos\github.com\<owner>\<repo>
+```
+
+Override the cache root if needed:
+
+```bash
+export PI_LIBRARIAN_CACHE_ROOT="$HOME/Library/Caches/pi-librarian/repos"
+```
+
+## Requirements
+
+- GitHub CLI (`gh`) installed and authenticated for private repositories you want to inspect
+- `git` for local checkout caching
+- common shell tools such as `rg`, `jq`, and `base64` for best results
+
+## Notes
+
+Do not install this alongside another extension that registers a `librarian` tool unless you intentionally want duplicate/conflicting tool names.