--- slug: "narumitw-pi-goal" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/narumiruna/pi-extensions@main/README.md" repo: "https://github.com/narumiruna/pi-extensions" source_file: "README.md" branch: "main" --- # 🧩 Pi Extensions for the Pi Coding Agent [![npm scope](https://img.shields.io/badge/npm-@narumitw-blue)](https://www.npmjs.com/org/narumitw) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE) Independently installable [Pi](https://pi.dev) Coding Agent extension packages for AI coding workflows. This TypeScript monorepo publishes npm packages under `@narumitw` and gives Pi native tools, slash commands, and statusline integrations for LSP diagnostics and code actions across JavaScript, TypeScript, Python, Rust, Go, Ruby, C/C++, JVM, .NET, Swift, shell, infrastructure formats, and more; Chrome DevTools Protocol browser automation; Firecrawl web scraping, crawling, and web search; Google GenAI grounding for Google Search, Maps, and URL context; Langfuse LLM observability; multi-provider subscription account switching and current-account provider usage for Codex and OpenRouter; GitHub pull request checks; autonomous goal mode with opt-in ordered queues; Codex-like plan mode; local browser image staging and lightweight current-session web chat; safe Git worktree management and Pi workspace switching; subagents; rich terminal statuslines; Cloudflare R2/S3 settings sync; retry handling; side questions; and keep-awake automation. **Search keywords:** Pi Coding Agent extensions, AI coding agent tools, npm Pi packages, LSP diagnostics, Language Server Protocol, Chrome DevTools Protocol, browser automation, web scraping, Firecrawl, Google GenAI grounding, browser image staging, browser session chat, image attachments, Langfuse, LLM observability, ChatGPT Codex tools, Git worktree management, workspace switching, subagents, terminal statusline, Cloudflare R2 sync, S3 sync. ## πŸ“¦ Pi extension packages Install only the Pi extensions you need. Each package is published under the `@narumitw` npm scope and can be installed directly with the package-specific `pi install npm:@narumitw/...` command. | Pi extension | What it adds | Install | | --- | --- | --- | | [`@narumitw/pi-btw`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-btw) | πŸ’¬ `/btw` side-question command for asking quick questions without polluting the main conversation. | `pi install npm:@narumitw/pi-btw` | | [`@narumitw/pi-caffeinate`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-caffeinate) | β˜• Cross-platform sleep prevention while the Pi agent is processing long-running prompts. | `pi install npm:@narumitw/pi-caffeinate` | | [`@narumitw/pi-chrome-devtools`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-chrome-devtools) | 🌐 Native Chrome DevTools Protocol tools for listing tabs, navigating pages, evaluating JavaScript, and taking screenshots. | `pi install npm:@narumitw/pi-chrome-devtools` | | [`@narumitw/pi-accounts`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-accounts) | πŸ” `/account` for independently switching named OpenAI Codex, Anthropic, and GitHub Copilot subscription OAuth accounts, with temporary Codex command aliases. | `pi install npm:@narumitw/pi-accounts` | | [`@narumitw/pi-usage`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-usage) | πŸ“Š Interactive `/usage` menu and current-account statusline for Codex subscription limits and OpenRouter API-key spend limits. | `pi install npm:@narumitw/pi-usage` | | [`@narumitw/pi-firecrawl`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-firecrawl) | πŸ”₯ Firecrawl-powered web scraping, crawling, URL discovery, and web search tools for documentation and research workflows. | `pi install npm:@narumitw/pi-firecrawl` | | [`@narumitw/pi-github-pr`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-github-pr) | πŸ”Ž Passive current-branch GitHub PR checks, review, and comment counts in the statusline. | `pi install npm:@narumitw/pi-github-pr` | | [`@narumitw/pi-goal`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-goal) | 🎯 `/goal` mode that keeps the agent working until verified completion, with an opt-in experimental ordered queue. | `pi install npm:@narumitw/pi-goal` | | [`@narumitw/pi-google-genai`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-google-genai) | πŸ”Ž Google GenAI grounding tools for Google Search, Maps, and URL context. | `pi install npm:@narumitw/pi-google-genai` | | [`@narumitw/pi-image-drop`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-image-drop) | πŸ–ΌοΈ `/image-drop` browser staging for ordered, memory-only image attachments on the next Pi message. | `pi install npm:@narumitw/pi-image-drop` | | [`@narumitw/pi-langfuse`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-langfuse) | πŸͺ’ Langfuse traces for Pi agent runs, LLM generations, token usage, costs, and tool activity. | `pi install npm:@narumitw/pi-langfuse` | | [`@narumitw/pi-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-lsp) | 🧠 Language-agnostic LSP diagnostics and code actions for JavaScript, TypeScript, Python, Rust, Go, Ruby, C/C++, JVM, .NET, Swift, shell, infrastructure formats, and more. | `pi install npm:@narumitw/pi-lsp` | | [`@narumitw/pi-plan-mode`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-plan-mode) | 🧭 Codex-like read-only `/plan` collaboration mode with safe exploration and implementation-ready plans. | `pi install npm:@narumitw/pi-plan-mode` | | [`@narumitw/pi-retry`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-retry) | πŸ” Retry support for unknown provider errors, retryable Codex backend failures, websocket limits, and stalled streams. | `pi install npm:@narumitw/pi-retry` | | [`@narumitw/pi-starship`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-starship) | πŸš€ Native Starship-style TOML footer with Pi-specific modules, palettes, and no Starship binary dependency. | `pi install npm:@narumitw/pi-starship` | | [`@narumitw/pi-statusline`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-statusline) | ✨ A rich Pi terminal statusline with model, tools, git branch/status, context usage, token totals, cost, and time. | `pi install npm:@narumitw/pi-statusline` | | [`@narumitw/pi-sync`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-sync) | ☁️ Sync allowlisted Pi settings, skills, prompts, themes, extensions, and optional sessions through Cloudflare R2 or S3-compatible storage. | `pi install npm:@narumitw/pi-sync` | | [`@narumitw/pi-subagents`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-subagents) | πŸ€– Delegate work to specialized isolated subagents with single, parallel, and chained execution modes. | `pi install npm:@narumitw/pi-subagents` | | [`@narumitw/pi-webui`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-webui) | 🌐 `/webui` lightweight browser companion for the current terminal Pi session, with semantic live sync and text/image input. | `pi install npm:@narumitw/pi-webui` | | [`@narumitw/pi-worktree`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-worktree) | 🌳 Interactive `/worktree` management for safe add/switch/remove/prune flows and session-backed Pi workspace switching. | `pi install npm:@narumitw/pi-worktree` | ## πŸš€ Quick start Install a package from npm: ```bash pi install npm:@narumitw/pi-goal ``` Try an extension once without adding it permanently: ```bash pi -e npm:@narumitw/pi-statusline pi -e npm:@narumitw/pi-sync ``` Use multiple Pi extensions together: ```bash pi -e npm:@narumitw/pi-goal -e npm:@narumitw/pi-statusline -e npm:@narumitw/pi-lsp ``` ## πŸ› οΈ Extension use cases ### 🧠 Shared language-server workflows Use [`@narumitw/pi-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-lsp) to let Pi run configurable Language Server Protocol servers through one shared runner. Without custom config, it provides direct-command routes across web, systems, scripting, JVM, .NET, mobile, markup, and infrastructure languages when the corresponding commands are available on `PATH`. Configure servers in `.pi/pi-lsp.json`, `~/.pi/agent/pi-lsp.json`, or `PI_LSP_CONFIG` with simple `{ command, extensions }` entries, then use Pi tools for diagnostics and source code actions. The older split packages [`@narumitw/pi-biome-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-biome-lsp) and [`@narumitw/pi-python-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-python-lsp) are deprecated, kept for reference, and excluded from active workspace scripts. ### 🧬 JavaScript and TypeScript coding with Biome Use [`@narumitw/pi-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-lsp) to route TypeScript, JavaScript, JSON, CSS, and other supported files to `biome lsp-proxy` for diagnostics and source actions such as organize imports or fix-all code actions. ### 🌐 Browser automation and debugging Use [`@narumitw/pi-chrome-devtools`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-chrome-devtools) when you want the Pi agent to inspect browser tabs, navigate web apps, run JavaScript in Chrome, or capture screenshots through the Chrome DevTools Protocol. ### πŸ”Ž Web scraping, crawling, and research Use [`@narumitw/pi-firecrawl`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-firecrawl) to give Pi native Firecrawl tools for scraping markdown or HTML, mapping URLs, crawling websites, and searching the web from inside an agent workflow. ### πŸ”Ž Google GenAI grounding Use [`@narumitw/pi-google-genai`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-google-genai) to give Pi Google Search, Google Maps, and URL-context grounding through Gemini Interactions with Pi Google auth or a private `pi-google-genai.json` config. ### πŸ–ΌοΈ Local image staging Use [`@narumitw/pi-image-drop`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-image-drop) to paste, drop, preview, and order images on a private loopback page, then attach the memory-only batch to the next non-empty interactive Pi message. `/image-drop` prints a one-time link and never launches a browser automatically. ### 🌐 Lightweight current-session web chat Use [`@narumitw/pi-webui`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-webui) to open a private loopback companion for the current terminal Pi session. `/webui` shows a one-time link; the page streams semantic messages and tool activity, sends text immediately or as follow-up/steer, and accepts sanitized image prompts without mirroring terminal ANSI pixels. ### πŸͺ’ LLM observability Use [`@narumitw/pi-langfuse`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-langfuse) to send Pi agent, generation, token usage, cost, and tool spans to Langfuse with credentials stored in a private `pi-langfuse.json` file. ### πŸ” Subscription OAuth accounts Use [`@narumitw/pi-accounts`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-accounts) to keep independently selected OpenAI Codex, Anthropic, and GitHub Copilot subscription OAuth accounts in a private `pi-accounts.json` file. Use `/account` to login, list, switch, or remove named accounts while retaining Pi's built-in login as each provider's `default` selection. ### πŸ“Š Current-account provider usage Use [`@narumitw/pi-usage`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-usage) to open one interactive `/usage` menu that follows Pi's selected model and active runtime credential. It reports Codex ChatGPT subscription windows or OpenRouter API-key spend limits, keeps the statusline scoped to the current account, and makes cross-provider queries explicit. ### πŸ”Ž GitHub pull request status Use [`@narumitw/pi-github-pr`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-github-pr) to passively show the current branch PR number, checks state, review state, and comment/review count in Pi's statusline through the authenticated `gh` CLI. ### 🐍 Python coding with ty and Ruff Use [`@narumitw/pi-lsp`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-lsp) to route Python files to configured servers such as `ty server` for type diagnostics and `ruff server` for lint diagnostics or source actions such as import organization. ### 🎯 Autonomous task completion Use [`@narumitw/pi-goal`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-goal) for long-running implementation, debugging, refactoring, or verification work where the agent should continue past planning and call `goal_complete` only after the active goal is done. Single-goal behavior remains the default. Set `experimental.goals` to `true` in `~/.pi/agent/pi-goal.json` to add ordered `/goal add`, `prioritize`, `drop-last`, and `skip` operations while retaining the same singular command and tools. ### 🧭 Read-only planning mode Use [`@narumitw/pi-plan-mode`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-plan-mode) when you want a Codex-like `/plan` mode where the agent explores with read-only tools, asks structured questions, and produces an implementation-ready plan before editing. ### 🌳 Git worktree workflows Use [`@narumitw/pi-worktree`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-worktree) to create Git worktrees, continue the current Pi conversation in another worktree through session-backed cwd switching, safely remove clean linked worktrees, and preview stale metadata before pruning. ### πŸ—ƒοΈ Deprecated extensions The Codex-only [`@narumitw/pi-codex-accounts`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-codex-accounts) and [`@narumitw/pi-codex-usage`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-codex-usage) packages are deprecated in favor of [`@narumitw/pi-accounts`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-accounts) and [`@narumitw/pi-usage`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-usage). [`@narumitw/pi-telegram-bot`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-telegram-bot), [`@narumitw/pi-telegraph`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-telegraph), and [`@narumitw/pi-wait-what`](https://github.com/narumiruna/pi-extensions/tree/HEAD/deprecated/pi-wait-what) are also deprecated and kept under `deprecated/` for reference. ### πŸ€– Delegated subagents Use [`@narumitw/pi-subagents`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-subagents) when you want the Pi agent to delegate scouting, planning, review, or implementation work to isolated worker processes with single, parallel, or chained execution. ### ✨ Better agent ergonomics Use [`@narumitw/pi-btw`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-btw), [`@narumitw/pi-caffeinate`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-caffeinate), and [`@narumitw/pi-retry`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-retry) for side questions, sleep prevention, and retry hints. Choose either [`@narumitw/pi-starship`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-starship) for a native Starship-style TOML footer or [`@narumitw/pi-statusline`](https://github.com/narumiruna/pi-extensions/tree/HEAD/extensions/pi-statusline) for the preset/JSON statusline; do not enable both footer extensions together. ## πŸ§‘β€πŸ’» Local development Install dependencies from the repository root: ```bash npm install ``` Run the full repository check: ```bash npm run check ``` Try a package locally: ```bash pi -e ./extensions/pi-btw pi -e ./extensions/pi-caffeinate pi -e ./extensions/pi-chrome-devtools pi -e ./extensions/pi-accounts pi -e ./extensions/pi-usage pi -e ./extensions/pi-firecrawl pi -e ./extensions/pi-github-pr pi -e ./extensions/pi-goal pi -e ./extensions/pi-google-genai pi -e ./extensions/pi-image-drop pi -e ./extensions/pi-langfuse pi -e ./extensions/pi-lsp pi -e ./extensions/pi-plan-mode pi -e ./extensions/pi-retry pi -e ./extensions/pi-starship pi -e ./extensions/pi-statusline pi -e ./extensions/pi-sync pi -e ./extensions/pi-subagents pi -e ./extensions/pi-webui pi -e ./extensions/pi-worktree ``` Preview npm package contents before publishing: ```bash npm run pack:btw npm run pack:caffeinate npm run pack:chrome-devtools npm run pack:accounts npm run pack:usage npm run pack:firecrawl npm run pack:github-pr npm run pack:goal npm run pack:google-genai npm run pack:image-drop npm run pack:langfuse npm run pack:lsp npm run pack:plan-mode npm run pack:retry npm run pack:starship npm run pack:statusline npm run pack:sync npm run pack:subagents npm run pack:webui npm run pack:worktree ``` Publishing note for new scoped packages: `just npm-public @narumitw/pi-new-extension` only changes visibility for an already-published package. If npm returns 404 for a brand-new package, create it first with the new package's workspace name, for example: ```bash npm publish --workspace @narumitw/pi-new-extension --access public ``` ## πŸ—‚οΈ Repository structure ```txt deprecated/ β”œβ”€β”€ pi-auto-thinking/ β”œβ”€β”€ pi-biome-lsp/ β”œβ”€β”€ pi-codex-accounts/ β”œβ”€β”€ pi-codex-usage/ β”œβ”€β”€ pi-python-lsp/ β”œβ”€β”€ pi-sidebar/ β”œβ”€β”€ pi-telegram-bot/ β”œβ”€β”€ pi-telegraph/ └── pi-wait-what/ extensions/ β”œβ”€β”€ pi-btw/ β”œβ”€β”€ pi-caffeinate/ β”œβ”€β”€ pi-chrome-devtools/ β”œβ”€β”€ pi-accounts/ β”œβ”€β”€ pi-usage/ β”œβ”€β”€ pi-firecrawl/ β”œβ”€β”€ pi-github-pr/ β”œβ”€β”€ pi-goal/ β”œβ”€β”€ pi-google-genai/ β”œβ”€β”€ pi-image-drop/ β”œβ”€β”€ pi-langfuse/ β”œβ”€β”€ pi-lsp/ β”œβ”€β”€ pi-plan-mode/ β”œβ”€β”€ pi-retry/ β”œβ”€β”€ pi-starship/ β”œβ”€β”€ pi-statusline/ β”œβ”€β”€ pi-sync/ β”œβ”€β”€ pi-subagents/ β”œβ”€β”€ pi-webui/ └── pi-worktree/ ``` Each production extension package contains its own `package.json`, `README.md`, `LICENSE`, `tsconfig.json`, and TypeScript source under `src/`. Experimental extensions live under `extensions/experimental/`, remain covered by root checks, and may be published only through an explicit local maintainer recipeβ€”not `publish-all` or GitHub workflows. Deprecated packages live under the root `deprecated/` directory and are excluded from workspace scripts. ## πŸ“„ License MIT. See [`LICENSE`](https://github.com/narumiruna/pi-extensions/tree/HEAD/LICENSE).