shariq-pi-extensions

Cross-platform extension suite for the Pi coding agent.

Packages

Package details

extensionskilltheme

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

npm repo home report

$ pi install npm:shariq-pi-extensions

Package: shariq-pi-extensions
Version: 0.3.6
Published: Sep 6, 2026
Downloads: 5,658/mo · 4,861/wk
Author: shariqriaz
License: MIT
Types: extension, skill, theme
Size: 685.4 KB
Dependencies: 2 dependencies · 5 peers

Pi manifest 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/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"
  ],
  "skills": [
    "./skills/background-terminals",
    "./skills/subagents"
  ],
  "themes": [
    "./themes/ember-warm-dark.json"
  ]
}

Security note

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

README

Shariq's Pi extensions

Cross-platform extensions and operating skills for the Pi coding agent. Credentials and runtime state stay on each machine and are never bundled with the package.

Install

Install from npm:

pi install npm:shariq-pi-extensions

Or install the latest source from GitHub:

pi install git:https://github.com/shariqriazz/shariq-pi-extensions

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

Included extensions

The package contains:

structured user questions
managed background terminals
Firecrawl web and developer search plus scraping
persistent task goals
branch-safe model-maintained task lists with live progress UI and compaction continuity
configurable steer, interrupt, or follow-up input behavior
Smart Compaction with high-fidelity checkpointing, delta-merging, and custom model routing
per-response TPS, TTFT, elapsed-time, and output status
Context Usage display
small shell and command shortcuts
Pi subagents
lightweight URL fetching

The package also includes the ember-warm-dark TUI theme and declares the background-terminals and subagents skills so Pi loads their operating guidance automatically. Pi reads them from the installed package; duplicating files under <agent-dir>/skills is unnecessary and would leave stale copies after removal.

See docs/EXTENSIONS.md for commands, tools, configuration, and external dependencies.

Enable or disable extensions

Open Pi's package configuration UI:

pi config

Toggle individual resources, save, and run /reload. Remove the installed package to disable the whole suite:

pi remove npm:shariq-pi-extensions

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

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 remains fixed until its reference is changed explicitly.

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. This keeps the same package usable on macOS and Linux and prevents updates from overwriting 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 repository workflow and release checks, and docs/ARCHITECTURE.md for package boundaries.

Credits and license

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.