There are many Pi extensions, but this one is mine.

@tungthedev/pi-extensions is a bundled Pi package that upgrades the default Pi experience with a better editor, inline Mermaid rendering, web research tools, skill loading, boomerang context summarization, tool-set/system prompt switching for Pi/Codex/Droid modes, and a TUI-first subagent manager.

The package currently ships these extensions:

• editor custom composer UI with cleaner status row
• mermaid for inline Mermaid rendering and a full diagram viewer
• web for WebSearch, WebSummary, and FetchUrl
• skill for loading local Pi skills with the skill tool
• boomerang for autonomous task execution with context summarization
• goal for Codex-style long-running goal tracking with token budgets
• pi-modes for Codex/Droid tool-set switching, prompts, and subagents
• ext-manager for managing extensions from inside Pi
• openai-responses-image-patch for preserving OpenAI Responses generated images

Install

From npm:

pi install npm:@tungthedev/pi-extensions

From git:

pi install https://github.com/tungthedev/pi-extensions

What You Get

Editor

The editor extension replaces Pi's default composer with a boxed editor UI and an extensible status row. It also integrates with the package's file and skill discovery features so autocomplete can stay consistent across modes.

Fixed editor mode is available as an opt-in setting. It pins the editor and status rows at the bottom of the terminal while the conversation scrolls above them, including mouse and keyboard scrolling inside the transcript area.

{
  "editor": {
    "fixedEditor": true
  }
}

You can toggle it from /pi-mode > Pin Editor.

Mermaid

The mermaid extension detects Mermaid code blocks in chat, renders them inline, and keeps a session diagram index you can browse later.

• Shortcut: ctrl+shift+m
• Command: /mermaid

Better grep and find

The workspace extension extends Pi-native file tools and routing discovery-heavy operations through the shared FFF backend. FFF improves fuzzy path resolution, repository discovery, and editor @path autocomplete

Commands:

• /fff-status shows the current FFF index state and storage paths for the session
• /fff-reindex triggers a rebuild of the current session index

Web Research

The web extension registers three tools:

• WebSearch for web discovery and current documentation lookup
• WebSummary for grounded summaries of a specific URL using Gemini URL Context
• FetchUrl for scraping user-provided URLs into markdown via a configured fetch provider

Web tools become available when provider credentials are available.

You can use enviromnent variables:

export GEMINI_API_KEY=your-gemini-key # for WebSearch and WebSummary
export EXA_API_KEY=your-exa-key # for WebSearch
export CLOUDFLARE_ACCOUNT_ID=your-account-id # for FetchUrl
export CLOUDFLARE_API_TOKEN=your-browser-rendering-token # need browser rendering edit permission
export FIRECRAWL_API_KEY=your-firecrawl-key # for FetchUrl
pi

Or via /pi-mode > Web Tools config:

Skills

The skill extension adds a global skill tool that resolves content from loaded Pi skills and returns the skill instructions directly to the agent.

Boomerang

The boomerang extension adds /boomerang, /boomerang-cancel, and ctrl+alt+b for running autonomous tasks and returning future context to compact handoff summaries. ctrl+alt+b cycles auto-boomerang through off, one-shot, always-on, and back to off.

Examples:

/boomerang Fix the login bug

Goal

The goal extension adds Codex-style long-running goal tracking with an above-editor progress widget, goal tools, and automatic continuation while a goal is active.

Commands:

• /goal <objective> starts or replaces the current goal
• /goal pause pauses goal continuation
• /goal resume resumes a paused goal
• /goal resume --budget N resumes with a new token budget
• /goal budget N sets the current goal token budget
• /goal budget 0 clears the token budget
• /goal clear clears the current goal

Pi Modes And Subagents

The pi-modes extension bundles several mode-specific surfaces:

• Pi/Codex/Droid tool-set switching
• Pi mode settings and prompt toggles
• Codex and Droid tools and system prompt
• Builtin subagents. You can also add yours.

Commands and shortcuts:

• /pi-mode opens the Pi mode settings UI or updates package settings
• /subagents opens the interactive subagent manager
• ctrl+alt+m cycles the active tool set between Pi, Codex, and Droid
• ctrl+alt+k toggles Load Skills for the current session without saving settings

Extension Manager

The ext-manager extension provides an in-app extension manager UI.

• Command: /extmgr

OpenAI Responses Image Patch

This package includes a global openai-responses API override that preserves generated images returned as OpenAI Responses image_generation_call items.

Generated PNG files are saved under ~/.pi/generated-images/YYYY-MM-DD/.

Themes

The package also ships bundled themes under themes/:

• ayu-dark
• one-dark-pro
• dracula

Package Layout

• extensions/ contains the Pi extension entrypoints declared in package.json
• src/ contains the implementation for editor, web, workspace, FFF, modes, subagents, and shared utilities
• themes/ contains bundled Pi themes

Library Usage

This package can also be imported from Pi SDK-based hosts.

• Root register APIs: @tungthedev/pi-extensions
• Stable bundle APIs: @tungthedev/pi-extensions/<module>
• Stable primitive APIs: @tungthedev/pi-extensions/<module>/primitives
• Tool metadata: @tungthedev/pi-extensions/metadata and @tungthedev/pi-extensions/<module>/metadata
• Direct source-level access: @tungthedev/pi-extensions/<source-path> maps to src/<source-path>.ts

Examples:

import { registerShellExtension } from "@tungthedev/pi-extensions";
import { registerCodexCompatibilityTools } from "@tungthedev/pi-extensions/codex-content/primitives";
import { registerShellTool } from "@tungthedev/pi-extensions/shell/primitives";
import { readPiModeSettings } from "@tungthedev/pi-extensions/settings/config";

export function registerCustomPack(pi: ExtensionAPI) {
  registerShellExtension(pi);
  registerCodexCompatibilityTools(pi);
  registerShellTool(pi);
}

License

MIT