pi-extensions

Collection of pi extensions — small, self-contained plugins that add tools, commands, and automatic behaviors to the pi coding agent.

Requires pi >= 0.81.1 for the current release.

Extensions

Extension	Description
pi-advisor	A parameterless advisor tool that forwards the full conversation transcript to a stronger reviewer model for direct, actionable advice.
pi-thinking-command	Adds a /thinking slash command for changing the active thinking/reasoning level from inside a session.
pi-timestamp	Shows user/agent timestamps plus session-switch and full Pi-runtime summaries.
pi-set-model	Remembers the selected model and thinking level separately for each project folder.

Installation

Via pi install from GitHub (bundle)

Install the entire collection via pi install:

pi install git:git@github.com:hknet/pi-extensions@main

Or via HTTPS:

pi install https://github.com/hknet/pi-extensions

Or install from a local checkout:

pi install /path/to/pi-extensions

This adds the package source to your pi settings (~/.pi/agent/settings.json under packages). Pi loads the extension files declared in this package's package.json pi.extensions manifest. Restart pi if needed, or reload the session with:

/reload

Via npm packages (individual extensions)

Install individual extensions from npm:

pi install npm:@hk_net/pi-advisor
pi install npm:@hk_net/pi-thinking-command
pi install npm:@hk_net/pi-timestamp
pi install npm:pi-set-model

Manual install (fallback)

Copy individual .ts files into pi's extensions directory:

mkdir -p ~/.pi/agent/extensions
cp packages/pi-advisor/advisor.ts ~/.pi/agent/extensions/advisor.ts
cp packages/pi-thinking-command/thinking-shortcut.ts ~/.pi/agent/extensions/thinking-shortcut.ts
cp packages/pi-timestamp/timestamp.ts ~/.pi/agent/extensions/timestamp.ts
cp packages/pi-set-model/set-model.ts ~/.pi/agent/extensions/set-model.ts

Structure

pi-extensions/
├── package.json               # Pi package manifest
├── README.md
├── packages/
│   ├── pi-advisor/
│   │   ├── package.json       # npm package @hk_net/pi-advisor
│   │   ├── README.md
│   │   └── advisor.ts         # Canonical source
│   ├── pi-thinking-command/
│   │   ├── package.json       # npm package @hk_net/pi-thinking-command
│   │   ├── README.md
│   │   └── thinking-shortcut.ts # Canonical source
│   ├── pi-timestamp/
│   │   ├── package.json       # npm package @hk_net/pi-timestamp
│   │   ├── README.md
│   │   └── timestamp.ts       # Canonical source
│   └── pi-set-model/
│       ├── package.json       # npm package pi-set-model
│       ├── README.md
│       └── set-model.ts   # Canonical source

The root package.json declares the pi.extensions manifest so pi install can load the declared .ts extension files from the package. Each extension is self-contained: a single TypeScript module exporting the extension factory function and its own README for documentation.

Privacy note

pi-advisor can send the active conversation transcript — including reasoning, tool calls, arguments, and tool results — to a reviewer model. It does not send transcripts until you explicitly configure a trusted reviewer model with /advisor, project/global advisor.json, or PI_ADVISOR_MODEL. Use /advise show for UI-only feedback; bare /advise is optimized for quick intervention and injects advice into the conversation (pipe when idle, steer while running).

Developing

1. Edit the .ts source in the extension's package directory.
2. Run npm test and npm run typecheck.
3. Re-deploy with pi install /path/to/pi-extensions (or copy manually and run /reload).
4. See each extension's README for configuration options and usage details.

Issues and feedback

Found a bug or have a feature request? Please report it on GitHub Issues.

For security vulnerabilities, please use GitHub's private vulnerability reporting instead of opening a public issue.