🧩 Pi Extensions for the Pi Coding Agent

Production-ready, independently installable Pi 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 TypeScript, JavaScript, Python, JSON, CSS, and more; Chrome DevTools Protocol browser automation; Firecrawl web scraping, crawling, and web search; Google GenAI grounding for Google Search, Maps, and URL context; ChatGPT Codex account switching and usage status; GitHub pull request checks; goal mode; Codex-like plan mode; subagents; rich terminal statuslines; Cloudflare R2/S3 settings sync; retry handling; /wait-what pause explanations; 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, ChatGPT Codex tools, 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.

🚀 Quick start

Install a package from npm:

pi install npm:@narumitw/pi-goal

Try an extension once without adding it permanently:

pi -e npm:@narumitw/pi-statusline
pi -e npm:@narumitw/pi-sync

Use multiple Pi extensions together:

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 to let Pi run configurable Language Server Protocol servers through one shared runner. Configure servers in .pi/lsp.json, ~/.pi/agent/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 and @narumitw/pi-python-lsp are deprecated, kept for reference, and excluded from active workspace scripts.

🧬 JavaScript and TypeScript coding with Biome

Use @narumitw/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 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 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 to give Pi Google Search, Google Maps, and URL-context grounding through Gemini Interactions with Pi Google auth or a private google-genai.json config.

🔐 Codex subscription accounts

Use @narumitw/pi-codex-accounts to keep multiple ChatGPT Codex subscription accounts in a private codex-accounts.json file and switch the active account with /codex-account. It does not add provider aliases or change Pi's built-in /login provider list.

📊 Codex usage status

Use @narumitw/pi-codex-usage to show ChatGPT Codex subscription usage and reset windows from Pi with /codex-status. When the current model uses openai-codex, it also shows compact quota status in the statusline. It uses Pi's OpenAI Codex auth first, so Codex CLI is optional.

🔎 GitHub pull request status

Use @narumitw/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 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 for long-running implementation, debugging, refactoring, and verification tasks where the agent should continue past planning and call goal_complete only after the goal is done.

🧭 Read-only planning mode

Use @narumitw/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.

🤔 Pause and explain surprising actions

Use @narumitw/pi-wait-what when you want to pause the agent and ask it to explain what it was doing, why, assumptions, and next step before it continues.

📨 Remote Telegram session chat

@narumitw/pi-telegram-bot is deprecated and kept under extensions/deprecated/ for reference.

🤖 Delegated subagents

Use @narumitw/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, @narumitw/pi-caffeinate, @narumitw/pi-retry, and @narumitw/pi-statusline to improve day-to-day Pi coding agent sessions with side questions, sleep prevention, automatic retry hints, and a more informative terminal UI.

🧑‍💻 Local development

Install dependencies from the repository root:

npm install

Run the full repository check:

npm run check

Try a package locally:

pi