dot-pi plugin
A Pi agent package: code search, LSP, web search, desktop control and confirmations for risky commands.
- 58 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The computer extension controls windows and applications on the computer.
- Search and docs send requests to Exa and Context7 using your keys.
Install
Manual install
pi install git:github.com/dannote/dot-piThe command from the Install section of the README after Pi itself is installed.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The computer extension controls windows and applications on the computer.
- Search and docs send requests to Exa and Context7 using your keys.
This is third-party code. Review the repository files before installing.
What it does
dot-pi bundles extensions, skills, prompt shortcuts and rules for the Pi coding agent. The default set includes `ast-grep` for syntax-tree search and rewrite, LSP tools (definitions, references, diagnostics, rename), `webfetch` and `websearch` through Exa, `codesearch` across public GitHub code, `context7` for current library docs and `worktrees` for isolated work. The `computer` extension gives the agent window and element discovery, screenshots and targeted desktop actions. `confirm-actions` asks before publishing, editing issues and PRs, deleting files, privileged commands and deploys, parsing the command as argv rather than by regex. `oracle` sends a question to an expensive model with context compaction. There are `/next` and `/recap` commands. Install with `pi install git:github.com/dannote/dot-pi` and configure through `pi config`.
Who it is for. Developers working in the Pi agent who want a ready extension set with protection from accidental irreversible actions.
Good fit when
- Pi is running and you want a vetted extension set instead of picking one by one.
- Before publishing a release or deleting a directory the agent must ask for confirmation.
- The project needs structural search and bulk rewrite by syntax tree.
- An expensive model should be asked rarely, with trimmed context.
Not a fit when
- Your main agent is Claude Code, Cursor or Codex.
- Exa and Context7 are unavailable and you have no keys.
- You need a minimal set without desktop control.
Example request
Find all calls of the deprecated function with ast-grep and replace them, and ask for confirmation before pushing.Limitations
The package works only with the Pi agent and needs Node.js 22.19 or newer and npm. The `websearch` and `context7` extensions need `EXA_API_KEY` and `CONTEXT7_API_KEY`, conveniently kept in `~/.pi/agent/env.jsonc`. `ast-grep` needs the `ast-grep` binary and LSP needs language servers. The install script can run as `curl | sh`, but it is safer to download and read `install.sh` first. The `computer` extension controls windows and applications on your machine; confirmations are on by default, but their list is configurable and can be switched off.
How to disable. Disable the package through `pi config` or remove the `git:github.com/dannote/dot-pi` entry from `packages` in `~/.pi/agent/settings.json`. For a project-local install with `-l` the entry lives in `.pi/settings.json`.
FAQ
How do I install the package?
Run `pi install git:github.com/dannote/dot-pi`. The `install.sh` script checks for Pi and asks extra questions, and has a `--dry-run` flag for a trial pass.
Which confirmations are on?
The filesystem, privilege, github, gitlab, git, gmail, twitter, publish and deploy groups. Disable any group in `confirmActionGroups` and add your own commands to `confirmCommands`.
How do I connect Gmail?
Through the external `@googleworkspace/cli`: `gws generate-skills` creates skills and you copy `gws-shared` and `gws-gmail*`. Write actions are covered by the package confirmation rules.
What does the computer extension do?
It discovers applications and windows, takes screenshots and runs targeted actions. A separate `agent-browser` reads web page content.
Are extra packages needed?
No, but `pi-elixir`, `pi-subagents` and `pi-context` are useful; install them separately with `pi install npm:<name>`.
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
An extension that gives the Pi agent LSP, linters, formatters and structural search on every code edit, plus an experimental MCP.
An extension stack for the Pi agent: code navigation through LSP and Tree-sitter, reviews, web access and library documentation.
Armin's personal toolkit for the Pi Coding Agent: 18 skills, extensions, commands and themes, with some skills portable to other agents
An extension for the Pi coding agent that folds tool calls into compact lines and renders file edits as readable diffs
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
A curated Pi package: extensions, skills and commands built around code search, LSP, web and confirmations of risky actions.