BTKS Pi Agent Pack

Enterprise extension pack for Pi Coding Agent.

Included Extensions

• btks-header: custom startup title and header.
• fd-shim: late repair and diagnostics for Windows search tools.
• superpowers: bundled Superpowers bootstrap extension.
• superpowers-sequencer: phase guidance for Superpowers workflows.

Included Skills

This package bundles the Superpowers skills/ directory and exposes it through the Pi package manifest. Users do not need to install git:github.com/obra/superpowers separately.

Install

New machine, install Pi and this pack together:

npx --yes --registry=https://registry.npmjs.org @mshen6666/pi-agent-pack

If Pi is already installed:

pi install npm:@mshen6666/pi-agent-pack@latest

Both commands run the package lifecycle. On Windows x64, that lifecycle installs verified fd.exe and rg.exe into Pi's private ~/.pi/agent/bin directory before the next interactive Pi startup.

Local install from this repository:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

To try it for one run:

pi -e npm:@mshen6666/pi-agent-pack

Updates

Update only this package:

pi update npm:@mshen6666/pi-agent-pack

Update all installed Pi packages:

pi update --extensions

pi update without --extensions updates Pi itself in current Pi versions; use one of the commands above when you want package lifecycle scripts to run again.

Package Gallery

This package is listed in the Pi package gallery:

https://pi.dev/packages/@mshen6666/pi-agent-pack

Safety

This package intentionally includes only the extensions/ directory, the bundled Superpowers skills/ directory, Windows search fallback binaries under assets/, install.ps1, and this README. It does not include local Pi configuration, model settings, auth files, session logs, or user-specific files.

Troubleshooting

If find reports that fd is unavailable, or grep reports that ripgrep is unavailable, run:

btks-doctor

On Windows x64, the pack verifies bundled hashes, preserves working existing executables, and installs missing or unusable fd.exe and rg.exe into ~/.pi/agent/bin. If Windows Defender blocks a copied executable, allow the file or reinstall the package, then run btks-doctor again.

If Superpowers does not activate, run:

pi list

Confirm @mshen6666/pi-agent-pack is installed and enabled. The package should expose both extensions and skills.

If the custom startup banner does not show, make sure quietStartup is not enabled in ~/.pi/agent/settings.json:

{
  "quietStartup": false
}