BTKS Pi Agent Pack

BTKS enterprise extension pack for Pi Coding Agent.

Included Extensions

Built into this pack:

• 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.

Bundled from locally installed Pi npm packages:

• @narumitw/pi-goal: goal tracking extension.
• pi-cache-optimizer: context/cache optimization extension.
• pi-intercom: cross-agent messaging extension and skill.
• pi-open-code-review: open code review extension and skill.
• pi-prompt-template-model: prompt template extension and skill.
• pi-subagents: subagent extension, skill, and prompt templates.
• pi-web-access: web/search/fetch extension and librarian skill.

The published Pi manifest exposes these entries from bundled copies:

• ./extensions
• ./extensions/superpowers-sequencer
• ./bundled/pi-packages/@narumitw/pi-goal/src/goal.ts
• ./bundled/pi-packages/pi-cache-optimizer/index.ts
• ./bundled/pi-packages/pi-intercom/index.ts
• ./bundled/pi-packages/pi-open-code-review/extensions/open-code-review.js
• ./bundled/pi-packages/pi-prompt-template-model/index.ts
• ./bundled/pi-packages/pi-subagents/src/extension/index.ts
• ./bundled/pi-packages/pi-web-access/index.ts

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.

It also exposes bundled skills from pi-intercom, pi-open-code-review, pi-prompt-template-model, pi-subagents, and pi-web-access. The pi-subagents prompt templates are exposed through the same package manifest.

Bundling Local Pi Packages

The goal is supported: this repository can publish one Pi package that carries your locally installed Pi npm packages. Other users install only npm:@mshen6666/pi-agent-pack and Pi loads the bundled copies through this package's manifest.

The sync source is Pi's local npm package root:

~/.pi/agent/npm/package.json
~/.pi/agent/npm/node_modules/

Before npm pack or npm publish, scripts/sync-pi-packages.mjs copies every dependency listed in ~/.pi/agent/npm/package.json into bundled/pi-packages, rewrites package.json pi.extensions, pi.skills, and pi.prompts to point at the bundled files, and adds the runtime dependencies needed by those packages.

Manual maintainer workflow:

node scripts/sync-pi-packages.mjs
npm test
npm pack --dry-run
npm publish --access public

npm pack and npm publish run the sync automatically, but running it manually makes the generated manifest and README checks easy to inspect before publishing.

This intentionally does not bundle user-specific Pi config, auth files, model settings, session logs, or arbitrary npm packages outside Pi's local package dependencies.

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 the extensions/ directory, bundled Superpowers skills/, bundled Pi package copies under bundled/pi-packages, Windows search fallback binaries under assets/, maintainer scripts, install entry points, 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 Pi prints fd not found. Downloading... and then times out, Pi is trying to use its own network download path before fd.exe exists locally. From this repository, run node scripts/install-search-tools.mjs; after the pack is installed, run btks-doctor.

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
}