@nklisch/pi-conveniences

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

Package details

extension

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

$ pi install npm:@nklisch/pi-conveniences

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ]
}

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

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

Surface	What it does
`/exit`	Gracefully 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` context	Loads `<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 footer	A 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` tool	Exposes 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.