Skip to content

w-winter/dot314

Repository files navigation

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.50.0+ (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.ts"
      ]
    }
  ]
}

Use !path to exclude specific extensions, or list only the ones you want. See package filtering for the full syntax.

Notes:

  • pi install ... runs npm install in 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
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.ts 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-cli/ pi-repoprompt-cli RepoPrompt bridge via rp-cli with syntax/diff rendering, read-cache, and branch-safe binding
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.ts /resume-style session picker with live preview
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/
extension-stats.ts
inline-bash.ts
interactive-shell.ts
pi-prompt-template-model/
preset.ts
rewind/
skill-palette/
subagent/
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/
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-guardrails (aliou) .env file protection + AST-based dangerous command gates pi install npm:@aliou/pi-guardrails
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-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. ⚠ Collides with sandbox/, so enable only one pi install npm:pi-tool-display
pi-verbosity-control (ferologics) Per-model OpenAI verbosity presets with configurable shortcut pi install npm:pi-verbosity-control
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.md 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
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-plan.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