@yceachan/pi-gadget

pi extension collection: /clear session archiving, /exit pi, pi_cite_wslpath WSL-link citing, and other single-file utilities

Packages

Package details

extension

Install @yceachan/pi-gadget from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@yceachan/pi-gadget

Package: @yceachan/pi-gadget
Version: 0.2.3
Published: Aug 17, 2026
Downloads: 357/mo · 357/wk
Author: yceachan
License: MIT
Types: extension
Size: 27.5 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./pi-clear.ts",
    "./pi-exit.ts",
    "./pi-cite-wslpath.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-gadget

A small collection of single-file pi extensions — handy gadgets, each living in one file:

/clear — archive the current session (moves it out of the way while keeping it resumable)
/exit — exit pi cleanly
pi_cite_wslpath — tool for the model: converts native (WSL) paths into Windows-Terminal-openable markdown hyperlinks, because file:///home/... / file:///mnt/c/... links are rejected by Windows Terminal. Takes a paths[] batch in one call; an agent_end hook force-checks every delivered reply for un-converted links and posts a clickable report (detect-and-tell)

Install

pi install npm:@yceachan/pi-gadget

Usage

Run /clear to archive the active session, /exit to quit pi. Both commands are plain slash-command extensions; see the source files for exact behavior.

pi_cite_wslpath is a tool the model calls to cite file paths clickable in Windows Terminal (Ctrl+click). Conversion rules: /mnt/<drive>/... → file:///<DRIVE>:/..., other Linux paths → file://wsl.localhost/<distro>/... (Windows Terminal ≥ 1.17). Outside WSL it falls back to the standard file:// URI.

The tool takes a paths array (one or more native paths) and returns exactly one markdown link per path ([label](uri)), which the model pastes verbatim into its reply — pi's Markdown renderer turns it into an OSC 8 hyperlink, so it stays clickable at any terminal width (the URL is hidden on screen and the terminal reconstructs the link across soft wraps). Raw OSC 8 sequences and bare URIs are deliberately not returned: a bare URI is long, wraps on narrow screens, and Windows Terminal's URL auto-detection cannot join the fragments. Each path is verified to exist on disk; a missing path gets a ! not found line so a misspelled filename is caught at cite time, before the link is delivered.

On agent_end the extension force-checks the delivered assistant text for file:// URIs Windows Terminal would reject (empty-host file:///... or file://localhost with a non-drive first segment, i.e. Linux-side paths). When any leaked, it reports rather than rewrites, delivering on agent_settled (the moment the run is fully settled — sending during agent_end would otherwise be queued by pi as a steering message): a one-line notify summary plus a chat custom message (>[!note] pi-cite-wslpath auto trans: with the converted markdown links) rendered by the same Markdown → OSC 8 pipeline as the chat body, so every link is clickable regardless of terminal width. Quoted examples are skipped (code spans, fenced code blocks, and ... ellipsis forms), so citing the guideline text itself does not trip the check.

License

MIT