SuPi plugin
An extension stack for the Pi agent: code navigation through LSP and Tree-sitter, reviews, web access and library documentation.
- 103 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Pi extensions run with the user's permissions and may change project files.
Install
- Works in
Manual install
npx @mrclrchtr/supi-installer@latestRun it in the project after `/trust` in Pi. A single package installs with `pi install npm:@mrclrchtr/supi-code-intelligence`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Pi extensions run with the user's permissions and may change project files.
This is third-party code. Review the repository files before installing.
What it does
SuPi is a TypeScript extension stack for the Pi coding agent. Its core is the `code_*` tools: the agent gets answers about types, definitions, references and diagnostics from language servers (LSP), while Tree-sitter parses source structure. The stack also adds web page reading as Markdown and Context7 documentation search, question forms for the user, independent review of chosen git changes, skill controls and context-pressure reports. Install the recommended stack or single packages. The `skills/` catalogue holds adapted skills installed with `npx skills add`.
Who it is for. Pi users who want an agent with precise code navigation rather than plain text search over files.
Good fit when
- In a large project the agent has to find every reference to a symbol and its implementations.
- A safe rename preview is wanted before a refactor.
- A long documentation page should not be loaded into context in full.
- An independent review of a chosen commit or branch should run in a separate session.
Not a fit when
- You work in another agent, not Pi: the extensions will not plug in.
- A stable release without beta packages is needed.
- The language has no language server on `PATH` and full LSP features are needed.
Example request
Find every reference to the `createClient` function, show its implementations and a preview of renaming it to `createApiClient`.Limitations
The README calls the project pre-release and part of the packages beta. Pi must be installed with `pi` on `PATH` and project trust saved through `/trust`. Tree-sitter is bundled, but full LSP works only when the matching language server is on `PATH`. Pi extensions run with the user's permissions, so review packages before installing. The skills from `skills/` install with a separate command and suit other agents.
How to disable. Clear the packages in the installer (`npx @mrclrchtr/supi-installer@latest`) or remove them with the Pi command. User data stays on removal. Then run `/reload` or restart Pi.
FAQ
How do I install a single package?
With `pi install npm:@mrclrchtr/supi-code-intelligence`, substituting the package name. Each package installs independently.
Is a language server required?
For full LSP, yes: the matching server must be on `PATH`. Tree-sitter is bundled, so syntax parsing works without a server.
Can the skills be used without Pi?
Yes. The adapted skills in `skills/` install with `npx skills add mrclrchtr/supi --skill code-review commit`.
Is it safe to install the extensions?
Extensions run with the user's permissions. The README advises reviewing packages before installing.
What does the installer do?
It shows a package table with Project and Global columns and, after selection, asks you to confirm additions and removals with `y`. It installs neither Pi nor project trust.
Discussion
No questions or reviews yet.
Related
PluginsMore than thirty separately installed extensions for the Pi Coding Agent: goals, plan mode, LSP and subscription limits
A Pi agent package: code search, LSP, web search, desktop control and confirmations for risky commands.
An extension that gives the Pi agent LSP, linters, formatters and structural search on every code edit, plus an experimental MCP.
Armin's personal toolkit for the Pi Coding Agent: 18 skills, extensions, commands and themes, with some skills portable to other agents
Native interface for the pi agent in Rust and GPUI: project sessions, a conversation tree, a changes panel and plugins.
An extension for Pi that runs vim, psql, ssh and other interactive CLIs in an overlay you can watch and take over.
README in short
The installer shows a package table with Project and Global columns, then asks to confirm additions and removals. It never grants trust and does not install Pi.