pi-power-pack

Subagents, background terminals, smart compaction, goals, a task list, ask_user, image, video, and audio understanding, WebP images, and web search for the Pi coding agent. Formerly shariq-pi-extensions.

Packages

Package details

extensionskilltheme

Install pi-power-pack from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-power-pack

Package: pi-power-pack
Version: 0.11.0
Published: Nov 1, 2026
Downloads: not available
Author: shariqriaz
License: MIT
Types: extension, skill, theme
Size: 847.7 KB
Dependencies: 5 dependencies · 5 peers

Pi manifest JSON

{
  "skills": [
    "./skills/background-terminals",
    "./skills/fusion",
    "./skills/subagents"
  ],
  "themes": [
    "./themes/ember-warm-dark.json"
  ],
  "extensions": [
    "./extensions/ask-user/index.ts",
    "./extensions/background-terminals/index.ts",
    "./extensions/context-usage/index.ts",
    "./extensions/firecrawl-web/index.ts",
    "./extensions/goal/index.ts",
    "./extensions/input-mode/index.ts",
    "./extensions/media-understanding/index.ts",
    "./extensions/performance-status/index.ts",
    "./extensions/shell-shortcuts/index.ts",
    "./extensions/smart-compaction/index.ts",
    "./extensions/subagents/index.ts",
    "./extensions/task-list/index.ts",
    "./extensions/web-fetch/index.ts",
    "./extensions/webp-images/index.ts"
  ],
  "changelogPath": "./docs/CHANGELOG.md"
}

Security note

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

README

Pi Power Pack

Subagents, background terminals, smart compaction, goals, a task list, structured questions, image, video, and audio understanding, WebP images, and web search for the Pi coding agent, in one package where every extension can be switched on or off.

Formerly shariq-pi-extensions, published on npm since August 2026 with 75 releases under that name. Same code and same author; only the name changed. See Moving from shariq-pi-extensions.

Install

pi install npm:pi-power-pack

Or install the latest source from GitHub:

pi install git:https://github.com/shariqriazz/pi-power-pack

Run /reload in an open Pi session after installing; new sessions load the package automatically.

What's included

Every extension can be turned off on its own with pi config. The defaults below are what a fresh install does.

Extension	What it does	Default
Subagents	Background Pi agents with profiles, worktree isolation, peer messaging, and a takeover dashboard. Delegates only when you ask, unless optional Fusion mode is on.	On; Fusion mode off
Background terminals	Servers, builds, and long scripts run in managed terminals while the agent keeps working; results come back on their own.	On
Smart Compaction	Structured checkpoints that keep files, worktree state, and running work when the context fills up.	On (`/smart-compaction` to change)
Goals	Long-running objectives with an evidence checklist and an optional token budget.	On
Task list	A live progress list for work with several deliverables.	On
Structured questions	`ask_user` lets the agent ask you a multiple-choice question instead of guessing.	On
Media understanding	Image zoom and questions, video and audio questions, and image descriptions from a helper model.	Off (`media-understanding.json`)
WebP images	Stores images as WebP, about a quarter of the size of PNG or JPEG, and sends JPEG to models without WebP support.	Off (`webp-images.json`)
Firecrawl web	`web_search`, `web_scrape`, and `dev_search` through Firecrawl.	On when a Firecrawl API key is set
Web fetch	`web_fetch` reads one known URL without spending search credits.	On
Context usage	A startup card showing where your context goes.	On
Performance status	Tokens per second, time to first token, and output status for each response.	On
Input mode	Choose whether Enter steers, interrupts, or queues a follow-up while the agent works.	On, using Pi's normal steer
Shell shortcuts	`/exit` as an alias for `/quit`.	On

The package also ships the ember-warm-dark theme and the background-terminals, fusion, and subagents skills. Pi loads the skills from the installed package; copying them into <agent-dir>/skills would leave stale duplicates after removal.

The suite is developed and tested against Pi 1.0 on Linux and macOS. See docs/EXTENSIONS.md for commands, tools, configuration, and external dependencies.

Turn extensions on or off

Open Pi's package configuration:

pi config

Toggle individual extensions, save, and run /reload. Extensions marked "Off" in the table also need their settings file under <agent-dir> before they do anything; each extension's README shows the settings.

To remove the whole package:

pi remove npm:pi-power-pack

For a Git installation, use pi remove git:https://github.com/shariqriazz/pi-power-pack.

Update

pi update --extensions --no-approve

An npm installation follows published versions. An unpinned Git installation follows the repository's default branch; a source pinned to a tag or commit stays fixed until you change its reference. After an update, Pi shows what changed from docs/CHANGELOG.md.

Moving from shariq-pi-extensions

shariq-pi-extensions is deprecated and gets no new releases. To switch:

pi remove npm:shariq-pi-extensions
pi install npm:pi-power-pack

Settings files such as smart-compaction.json and subagents.json keep working because they belong to each extension, not to the package. Extensions you turned off with pi config need turning off again, because Pi stores those choices per package. Do not install both packages at once; they register the same tools.

Machine-local configuration

The repository never contains credentials. Configure authentication separately on each machine through Pi login, environment variables, or the service's normal credential store.

Runtime files use Pi's active agent directory rather than a fixed home or checkout path, so the same package works on macOS and Linux and updates never overwrite state.

Development

mise install --locked
mise exec --locked -- bun install
mise exec --locked -- bun run validate
mise exec --locked -- bun run pack:inspect

See docs/DEVELOPMENT.md for the repository workflow and release checks, and docs/ARCHITECTURE.md for package boundaries.

Credits and license

Follow updates on X: @shariqriazzz.

Parts of this suite began with work by Ben Davis and Thomas Mustier. See THIRD_PARTY_NOTICES.md for details.

Released under the MIT License.