@nklisch/pi-conveniences

extensionmaintained

Small drop-in quality-of-life conveniences for Pi — /exit, .agents/AGENTS.md context loading, context-window footer, and subagent model listing.

by · v0.1.1 · published 1w ago

$ pi install npm:@nklisch/pi-conveniences
downloads/mo
0
stars
0
last push
17h ago
open issues
0

Signals

license: MITtestspi manifest: missinginstall size: —deps: 0peer deps: 0

Download trend

263 downloads · last 12 weeks (weekly)

README

@nklisch/pi-conveniences

Small drop-in quality-of-life conveniences for Pi. Each is a tiny extension in extensions/; install the package once and they all load.

pi install npm:@nklisch/pi-conveniences

Conveniences

SurfaceWhat it does
/exitGracefully shuts Pi down — alias for the built-in /quit, for shell and Claude Code muscle memory. Runs session_shutdown handlers before exiting.
.agents/AGENTS.md contextLoads <cwd>/.agents/AGENTS.md as a project context file. Pi natively walks ancestors and cwd for AGENTS.md, but does not look inside a .agents/ tree — this closes that gap for projects that keep agent assets under .agents/.
Context-window footerA footer widget showing live context-window usage as a bar, with a toggle command. Coordinates with pi-catppuccin-tui's packaged footer so only one footer owner is active (opt out with PI_CONVENIENCES_DISABLE_CATPPUCCIN_FOOTER=0).
list_subagent_models toolExposes Pi's configured model registry to the agent — available/scope-aware model listing with provider/model filters, so subagent spawning never guesses model identifiers.

Grew out of @nklisch/pi-nates-toolkit's extension surfaces and a set of personal pi-config extensions.