🧩 Pi Extensions for the Pi Coding Agent

Independently installable Pi Coding Agent extensions and reusable extension libraries for coding, research, browser automation, workflow management, observability, and terminal ergonomics.

Install only what you need. Every package is published separately under the @narumitw npm scope.

🚀 Quick start

Install an extension permanently:

pi install npm:@narumitw/pi-goal

Try one without adding it permanently:

pi -e npm:@narumitw/pi-statusline

Combine multiple extensions:

pi -e npm:@narumitw/pi-goal \
  -e npm:@narumitw/pi-statusline \
  -e npm:@narumitw/pi-lsp

Important

Pi extensions run with your full user permissions. Review an extension before installing it from any third party.

📦 Choose an extension

Coding and delegation

Package	Use it for	Install
pi-lsp	Language-server diagnostics and code actions across JavaScript, TypeScript, Python, Rust, Go, Ruby, C/C++, JVM, .NET, Swift, shell, infrastructure formats, and more.	pi install npm:@narumitw/pi-lsp
pi-plan-mode	Codex-like, read-only /plan collaboration before implementation begins.	pi install npm:@narumitw/pi-plan-mode
pi-subagents	Delegate isolated work in single, parallel, or chained execution modes.	pi install npm:@narumitw/pi-subagents

Browser and research

Package	Use it for	Install
pi-chrome-devtools	Inspect tabs, navigate pages, evaluate JavaScript, and capture screenshots through Chrome DevTools Protocol.	pi install npm:@narumitw/pi-chrome-devtools
pi-firecrawl	Scrape pages, crawl websites, discover URLs, and search the web with Firecrawl.	pi install npm:@narumitw/pi-firecrawl
pi-google-genai	Ground agent work with Google Search, Google Maps, and URL context.	pi install npm:@narumitw/pi-google-genai

Task and workspace workflows

Package	Use it for	Install
pi-btw	Ask a quick /btw side question without adding it to the main conversation.	pi install npm:@narumitw/pi-btw
pi-caffeinate	Prevent system sleep while Pi processes a long-running prompt.	pi install npm:@narumitw/pi-caffeinate
pi-goal	Keep the agent working until a goal is verified complete; optionally enable an experimental ordered queue.	pi install npm:@narumitw/pi-goal
pi-worktree	Create, switch, remove, and prune Git worktrees while carrying the Pi session into another workspace.	pi install npm:@narumitw/pi-worktree

Accounts and data

Package	Use it for	Install
pi-accounts	Switch named OpenAI Codex, Anthropic, and GitHub Copilot subscription OAuth accounts with /account.	pi install npm:@narumitw/pi-accounts
pi-usage	View current-account Codex subscription limits or OpenRouter API-key spend limits with /usage.	pi install npm:@narumitw/pi-usage
pi-sync	Sync allowlisted Pi settings and optional sessions through Cloudflare R2 or S3-compatible storage.	pi install npm:@narumitw/pi-sync

Status and observability

Package	Use it for	Install
pi-github-pr	Show current-branch pull request checks, reviews, and comment counts through the authenticated gh CLI.	pi install npm:@narumitw/pi-github-pr
pi-langfuse	Send agent runs, generations, token usage, costs, and tool activity to Langfuse.	pi install npm:@narumitw/pi-langfuse
pi-stamp	Show configurable timestamps with opt-in assistant metadata, response timing, and tool timing in the TUI transcript.	pi install npm:@narumitw/pi-stamp
pi-starship	Use a native Starship-style TOML footer with Pi-specific modules and no Starship binary dependency.	pi install npm:@narumitw/pi-starship
pi-statusline	Show model, tools, Git state, context usage, tokens, cost, and time in a preset or JSON-configured footer.	pi install npm:@narumitw/pi-statusline

Choose either pi-starship or pi-statusline; do not enable both footer extensions together.

Browser companions

Package	Use it for	Install
pi-image-drop	Stage an ordered, memory-only image batch in a private loopback page for the next Pi message.	pi install npm:@narumitw/pi-image-drop

🧱 Extension libraries

Package	Use it for	Install
pi-tui-kit	Extend @earendil-works/pi-tui with reusable navigation helpers and declarative action, detail, settings, and multi-select flows.	npm install @narumitw/pi-tui-kit

Libraries are runtime dependencies for extension authors, not standalone Pi extensions. New standard manager menus should use @narumitw/pi-tui-kit; extensions continue to own domain state, commands, settings persistence, confirmations, and specialized UI.

🧪 Experimental extensions

Warning

Experimental extensions are published and installable, but their interaction models and package APIs may change between releases.

Package	Use it for	Install
pi-analytics	Review private, content-free local metrics for model calls, skills, tools, response cycles, and observed provider reliability through /analytics.	pi install npm:@narumitw/pi-analytics
pi-codex-compact	Use OpenAI Codex Remote Compaction V2 to persist and replay bounded opaque checkpoints, with /codex-compact manual controls and safe Pi-native fallback.	pi install npm:@narumitw/pi-codex-compact
pi-file-context	Browse project files, preview text, select exact lines or Git diff hunks, and attach immutable snapshots with Git provenance to the next prompt. Open it by typing @ at a word boundary or running /file-context.	pi install npm:@narumitw/pi-file-context
pi-jupyter	Choose and preview saved Jupyter notebooks from one /jupyter current-state menu without running a kernel.	pi install npm:@narumitw/pi-jupyter
pi-webui	Use a private loopback browser companion for the current terminal session with live activity and text/image input.	pi install npm:@narumitw/pi-webui

🔧 Advanced installation

Install this repository directly from GitHub

Install the repository as one Pi package:

pi install git:github.com/narumiruna/pi-extensions

The repository root auto-discovers every production extension under extensions/, so this enables all of them. Experimental packages under experimental/ are not auto-discovered by the root Git package.

To load only selected extensions, replace the installed package entry in ~/.pi/agent/settings.json with a resource filter:

{
  "packages": [
    {
      "source": "git:github.com/narumiruna/pi-extensions",
      "extensions": [
        "extensions/pi-accounts/src/index.ts",
        "extensions/pi-usage/src/index.ts"
      ]
    }
  ]
}

Filters use resource paths relative to the repository root. A package directory such as extensions/pi-accounts is not enough; select its src/index.ts entrypoint.

Restart Pi or run /reload after changing the filter. Update the checkout later with:

pi update --extensions

🧑‍💻 Local development

From the repository root:

npm install
npm run check

Use the generic Just recipes with an unscoped extension name:

just try goal
just pack goal

# Experimental packages use the same recipes
just try file-context
just pack file-context

# Libraries have dedicated pack recipes
just pack-tui-kit

Run just --list to see all development, install, pack, and publishing recipes.

Publishing a new scoped package

just npm-public @narumitw/pi-new-extension only changes visibility for an existing npm package. If npm returns 404 for a brand-new package, publish it once with public access:

npm publish --workspace @narumitw/pi-new-extension --access public

After the initial publication, the shared release workflow handles libraries, production extensions, and publishable experimental packages.

🗂️ Repository structure

packages/                Reusable publishable extension libraries
extensions/              Production extension packages
experimental/            Published experiments with visible stability warnings
deprecated/              Reference packages excluded from active workspace scripts
docs/                    Repository conventions and plans
scripts/                 Shared checks, tests, versioning, and release helpers
test/                    Root integration and repository tests

Each active package contains its own package.json, README.md, LICENSE, tsconfig.json, and TypeScript source under src/. Extension src/index.ts files are thin Pi entrypoints; reusable libraries publish built ESM and declarations from dist/.

Deprecated packages

The following packages remain available as source references but are excluded from active workspace scripts:

• pi-biome-lsp and pi-python-lsp — replaced by pi-lsp
• pi-codex-accounts — replaced by pi-accounts
• pi-codex-usage — replaced by pi-usage
• pi-retry — replaced by Pi's built-in provider retry and timeout behavior
• pi-auto-thinking
• pi-sidebar
• pi-telegram-bot
• pi-telegraph
• pi-wait-what

📄 License

MIT. See LICENSE.