原始内容
.π
Extensions, skills, prompts, and themes for the Pi coding agent. Several of the extensions and prompts are designed to facilitate integration of Pi and RepoPrompt.
This collection is tailored to my workflow and preferences. I may introduce breaking changes without notice. While most of the extensions are original or modified, some that were authored by others are republished here unmodified, and those may lag well behind their upstream versions. Extensions published as Pi packages receive my active maintenance.
Provenance key
| Symbol | Meaning |
|---|---|
| ● | original |
| ◐ | forked & modified |
| ○ | republished unmodified |
Quick start
pi install git:github.com/w-winter/dot314 # install the package
pi config # enable/disable individual extensions and themes
Or try it for a single run without installing:
pi -e git:github.com/w-winter/dot314
Installation
Install as a Pi package
Requires Pi 0.63.1+ (see packages.md)
Install from git:
pi install git:github.com/w-winter/dot314
# (or with the raw URL)
pi install https://github.com/w-winter/dot314
Project-local install (writes to .pi/settings.json):
pi install -l git:github.com/w-winter/dot314
After installing, use pi config to enable/disable individual extensions, skills, and themes. You can also filter in settings.json, as in this example:
{
"packages": [
{
"source": "git:github.com/w-winter/dot314",
"extensions": [
"./extensions/anycopy/index.ts",
"./extensions/branch-out/index.ts",
"./extensions/command-center/index.ts",
"./extensions/editor-enhancements/index.ts",
"./extensions/ephemeral-mode.ts",
"./extensions/files-touched.ts",
"./extensions/grounded-compaction/index.ts",
"./extensions/model-aware-compaction/index.ts",
"./extensions/move-session.ts",
"./extensions/repoprompt-mcp/src/index.ts",
"./extensions/session-ask/index.ts",
"./extensions/session-switch/index.ts"
]
}
]
}
Use !path to exclude specific extensions, or list only the ones you want. See package filtering for the full syntax.
Notes:
pi install ...runsnpm installin the package root automatically- Some extensions store optional per-user config under
~/.pi/agent/extensions/<extension-name>/...(e.g.poly-notify,sandbox,tools,rp-native-tools-lock). These files are not part of the package install and are created on-demand or are optional.
Install individual extensions from npm
Many extensions are also published as standalone npm packages (see the npm column below). They can be installed with:
pi install npm:<package-name>
For example, pi install npm:pi-repoprompt-mcp.
See packages/ for all available npm packages.
Extensions
See extensions/README.md for more detailed descriptions.
Included in the Pi package
| Extension | npm | Description | |
|---|---|---|---|
| ● | anycopy/ |
pi-anycopy |
/tree with live syntax-highlighted preview + copy |
| ● | assistant-provenance/ |
pi-assistant-provenance |
Gives models awareness of mid-session model switches |
| ◐ | branch-out/ |
pi-branch-out |
Fork session into split pane or new tab with layout policies and optional model/message queuing |
| ● | brave-search/ |
pi-brave-search |
Web search + content extraction. 🔄 Consider pi-web-access for general-purpose search |
| ◐ | cmux/ |
cmux sidebar integration + workspace auto-renaming; no-op outside cmux | |
| ● | command-center/ |
pi-command-center |
/command palette widget |
| ◐ | editor-enhancements/ |
File picker, shell completions, raw paste, double-esc and slash command remapping | |
| ● | ephemeral-mode.ts |
pi-ephemeral |
Delete session on exit |
| ◐ | files-touched.ts |
Files read/modified/ widget with path normalization and tracking coverage of Pi-native tools, RepoPrompt, and bash | |
| ● | fork-from-first.ts |
pi-fork-from-first |
Quickly fork session from first message to establish parent-child lineage in a blank new session |
| ● | grounded-compaction/ |
pi-grounded-compaction |
Compaction summarizer with model presets, custom prompts, and files-touched tracking |
| ◐ | handover/ |
Handover draft with files-touched → fork-from-first → prefill editor | |
| ● | iterm-tab-color.ts |
Two-state tab coloring (running vs. idle) for iTerm2 | |
| ● | md.ts |
pi-md-export |
Export session branch or last N turns to Markdown file or clipboard |
| ● | model-aware-compaction/ |
pi-model-aware-compaction |
Per-model compaction thresholds |
| ● | model-sysprompt-appendix/ |
pi-model-sysprompt-appendix |
Per-model system prompt additions |
| ● | move-session.ts |
pi-move-session |
Move current active session to a new cwd |
| ◐ | oracle.ts |
Second opinion from alternate model | |
| ◐ | plan-mode.ts |
pi-plan-modus |
Read-only planning sandbox with RepoPrompt support |
| ● | poly-notify/ |
pi-poly-notify |
Desktop / sound / Pushover notifications |
| ● | protect-paths.ts |
Directory protection, brew prevention, command gates. 🔄 Pair with @aliou/pi-guardrails for .env + AST gates |
|
| ● | repoprompt-mcp/ |
pi-repoprompt-mcp |
RepoPrompt MCP proxy with adaptive diff rendering, collapsed outputs, read-cache, and branch-safe binding |
| ● | reverse-thinking.ts |
Backward thinking-level cycling on shift+alt+tab |
|
| ● | roam/ |
pi-roam |
Post-hoc tmux handoff for remote continuation of sessions |
| ● | rp-native-tools-lock/ |
pi-repoprompt-tools-lock |
Prefer RP tools over Pi native tools |
| ◐ | sandbox/ |
OS-level sandboxing | |
| ● | session-ask/ |
pi-session-ask |
Query "pre-historical" context (post-compaction, post-fork/handoff) via subagent |
| ◐ | session-switch/ |
/resume-style session picker with live preview, plus pi --switch-session startup relaunch |
|
| ● | skill-templates/ |
pi-skill-templates |
Nunjucks-templated SKILL.template.md skills rendered from invocation args, options, and flags, and composed from other skills |
| ◐ | tools/ |
UI for enabling/disabling active Pi tools | |
| ◐ | usage-bar.ts |
Provider quota overlay |
Also included
These extensions are tracked in the repository but not exported by the Pi package.
| Extension | |
|---|---|
| ◐ | agentic-compaction/ |
| ○ | code-actions/ |
| ● | context-limit-fallback/ |
| ◐ | extension-stats.ts |
| ● | inline-shell.ts |
| ○ | interactive-shell.ts |
| ○ | preset.ts |
| ● | repoprompt-cli/ |
| ◐ | rewind/ — archived; use upstream pi-rewind-hook |
| ○ | skill-palette/ |
| ● | subagent-bridge/ |
| ○ | titlebar-spinner.ts |
| ○ | todos.ts |
Other recommended extensions
These other extensions have also improved my QoL in Pi, so I recommend checking them out.
| Extension | Description | Install |
|---|---|---|
| bookmark (badlogic) | /bookmark <label> to label the last message in the session tree |
Copy to ~/.pi/agent/extensions/ |
| diff (badlogic) | /diff shows git-changed files and opens selected file in VS Code's diff view |
Copy to ~/.pi/agent/extensions/ |
| diligent-pi (crstdr) | /diligent-context hides past tool calls from the context, a useful alternative to compaction in some types of sessions |
|
| greprip (kaofelix) | Transparent interception of grep/find commands, translating them to rg/fd for speed |
uv tool install git+https://github.com/kaofelix/greprip + shell config |
| loop (mitsuhiko) | /loop starts a follow-up loop with a breakout condition |
Copy to ~/.pi/agent/extensions/ |
| pi-codex-goal (fitchmultz) | Durable Codex-style /goal command with get_goal, create_goal, and update_goal tools; goal state persists across compaction and session recovery |
pi install npm:pi-codex-goal |
| pi-gpt-config (edxeth) | Configuration of OpenAI models' API-side parameters like verbosity, fast mode, etc. | pi install git:github.com/edxeth/pi-gpt-config |
| pi-guardrails (aliou) | .env file protection + AST-based dangerous command gates |
pi install npm:@aliou/pi-guardrails |
| pi-interactive-subagents (HazAT) | Spawn, orchestrate, and manage async subagent sessions in multiplexer cmux panes; main agent keeps working while subagents run in the background | pi install git:github.com/HazAT/pi-interactive-subagents |
| pi-intercom (nicobailon) | Direct 1:1 messaging between Pi sessions; augments subagents nicely | pi install npm:pi-interview |
| pi-interview (nicobailon) | Interactive form-based input gathering with native window support | pi install npm:pi-interview |
| pi-nvim (aliou) | Bidirectional Neovim integration: nvim_context tool, LSP diagnostics at turn end, file reload after edits, visible-splits injection |
Neovim plugin; see setup instructions |
| pi-prompt-template-model (nicobailon) | Adds model, skill, and thinking frontmatter to pi prompt templates and chained prompt template execution |
pi install npm:pi-prompt-template-model |
| pi-queue-steer (tmustier) | Cursor-inspired visible steering and follow-up timeline: queue instructions while the agent works, with editable steering (next turn) and follow-up (after run) lanes | pi install git:github.com/tmustier/pi-queue-steer |
| pi-rtk-optimizer (MasuRii) | Read-tool-kit context optimization for token efficiency | pi install npm:pi-rtk-optimizer |
| pi-screenshots-picker (Graffioh) | Quick screenshot selection and attachment for prompts | pi install npm:pi-screenshots-picker |
| pi-token-burden (Whamp) | Token usage breakdown and context burden analysis | pi install npm:pi-token-burden |
| pi-tool-display (MasuRii) | Compact tool call rendering with diff visualization | pi install npm:pi-tool-display |
| pi-web-access (nicobailon) | Gemini-powered web search with AI-synthesized overviews and citations | pi install npm:pi-web-access |
| whimsical (mitsuhiko) | Whimsical messages while the agent is working | Copy to ~/.pi/agent/extensions/ |
Themes
| Theme | |
|---|---|
| ● | violet-dawn.json |
| ● | violet-dusk.json |
Skills
The Pi package does not export skills. See skills/README.markdown for full descriptions.
| Skill | Notes | |
|---|---|---|
| ○ | agent-browser/ |
|
| ◐ | dev-browser/ |
🔄 Prefer surf/ for browsing/scraping, agent-browser/ for structured testing |
| ○ | gdcli/ |
|
| ● | repoprompt-tool-guidance-refresh/ |
Maintainer workflow |
| ● | rp-deep-build/ |
Requires pi-codex-goal |
| ○ | surf/ |
|
| ◐ | text-search/ |
|
| ◐ | xcodebuildmcp/ |
Prompts
Prompts are not exported as part of the Pi package.
See prompts/README.md for full descriptions.
/command prompts
| Prompt | |
|---|---|
| ● | rp-address-review.md |
| ● | rp-review-chat.md |
AGENTS.md prefaces for reliable RepoPrompt tool usage — see AGENTS-prefaces/README.md
| Preface | |
|---|---|
| ● | AGENTS-prefaces/rp-cli-preface.md |
| ● | AGENTS-prefaces/rp-mcp-preface.md |
| ● | AGENTS-prefaces/rp-mcp-preface-exPi.md |