🧩 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.
Published packages use the @narumitw npm scope, and package READMEs identify source-only exceptions.
🚀 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.
⭐ Extensions I use every day
These extensions are part of my daily Pi setup:
| Extension | Why I use it |
|---|---|
pi-btw |
Ask a quick side question without polluting the main context. |
pi-accounts |
Switch between named subscription OAuth accounts. |
pi-caffeinate |
Keep my machine awake so Pi can keep working. |
pi-codex-compact |
Spend a little more for better compaction quality. |
pi-stamp |
See useful details for each response, such as its timestamp. |
pi-starship |
Match Pi's footer to my Starship shell setup. |
pi-sync |
Sync my Pi configuration across all my devices through S3. |
pi-usage |
Check my Codex usage and limit reset times without opening Codex. |
📦 Choose an extension
Coding and delegation
| Package | Use it for | Install |
|---|---|---|
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-context-management |
Opt into experimental summary-free context rollover with bounded branch-history recall and branch-local notes. | pi install npm:@narumitw/pi-context-management |
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 with configurable Ctrl+Shift+X or /file-context. |
pi install npm:@narumitw/pi-file-context |
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 |
Start bounded background Pi jobs with authenticated main-agent messaging. | Install from source |
TypeSafe AI
These TypeSafe AI integrations are experimental and may change as they are evaluated in real workflows.
| Package | Use it for | Install |
|---|---|---|
pi-typesafe |
Make typed Jev decisions with validated probabilities for yes-or-no, fixed-choice, and ordered-score questions. | pi install npm:@narumitw/pi-typesafe |
pi-typesafe-compact |
Use Jev to select older history before summarizing it with Pi's native compaction flow and active model. | pi install npm:@narumitw/pi-typesafe-compact |
pi-typesafe-search |
Search workspace files with SQLite FTS5 and Jev semantic reranking, without embeddings or a vector database. | pi install npm:@narumitw/pi-typesafe-search |
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 |
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-notes |
Browse and edit global Markdown notes in an isolated embedded-agent workspace. | pi install npm:@narumitw/pi-notes |
pi-progress |
Keep branch-aware multi-step work visible above the editor with the update_progress model tool. |
pi install npm:@narumitw/pi-progress |
pi-worktree |
Create, switch, remove, and prune Git worktrees while carrying the Pi session into another workspace. | pi install npm:@narumitw/pi-worktree |
Current Plan and Goal releases can coexist on the characterized Pi runtime through their anonymous cooperative workflow mutex.
The deprecated combined pi-workflow package has no atomic Plan-to-Goal replacement; follow its archived migration instructions.
Local collaboration
| Package | Use it for | Install |
|---|---|---|
pi-chat |
Join ephemeral peer-to-peer chat rooms that stay separate from Pi sessions, prompts, and model context. | pi install npm:@narumitw/pi-chat |
pi-fleet |
Start a separate Pi process in a terminal split and connect explicit local Pi sessions for bounded messages and one-turn requests. | pi install npm:@narumitw/pi-fleet |
pi-herdr |
Report Pi lifecycle state to Herdr and bundle safe Herdr terminal-orchestration guidance. | pi install npm:@narumitw/pi-herdr |
Accounts and data
| Package | Use it for | Install |
|---|---|---|
pi-accounts |
Switch named OpenAI Codex, Anthropic, GitHub Copilot, Kimi For Coding, OpenRouter, Radius, and xAI OAuth accounts with /accounts. |
pi install npm:@narumitw/pi-accounts |
pi-dotenv |
Load one explicit dotenv file early enough for provider credential discovery during normal Pi startup. | pi install npm:@narumitw/pi-dotenv |
pi-recall |
Save selected text messages locally and preview or quote them across Pi sessions. | pi install npm:@narumitw/pi-recall |
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-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-cache-hit-monitor |
Show live prompt-cache reuse, token, and estimated cost diagnostics above the editor. | pi install npm:@narumitw/pi-cache-hit-monitor |
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 |
pi-tool |
Browse every configured tool and inspect its active state, source, parameter schema, and prompt guidelines with /tool. |
pi install npm:@narumitw/pi-tool |
pi-ticker |
Show configurable Yahoo Finance market quotes in a width-aware widget above the editor. | pi install npm:@narumitw/pi-ticker |
Choose either pi-starship or pi-statusline; do not enable both footer extensions together.
🧱 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