https://github.com/w-winter/dot314

Pi extensions
https://github.com/w-winter/dot314
pi pi-agent pi-coding-agent pi-extension pi-package repoprompt
Last synced: 27 days ago
JSON representation
Pi extensions
Host: GitHub
URL: https://github.com/w-winter/dot314
Owner: w-winter
License: mit
Created: 2026-01-19T10:55:46.000Z (4 months ago)
Default Branch: main
Last Pushed: 2026-04-22T13:07:48.000Z (about 1 month ago)
Last Synced: 2026-04-22T15:10:23.622Z (about 1 month ago)
Topics: pi, pi-agent, pi-coding-agent, pi-extension, pi-package, repoprompt
Language: TypeScript
Homepage:
Size: 21.4 MB
Stars: 90
Watchers: 3
Forks: 10
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

          # .π

Extensions, skills, prompts, and themes for the [Pi coding agent](https://github.com/badlogic/pi-mono).  Several of the extensions and prompts are designed to facilitate integration of Pi and [RepoPrompt](https://repoprompt.com/docs#s=overview).

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](#install-individual-extensions-from-npm) receive my active maintenance.

## Provenance key

| Symbol | Meaning |

|--------|-------------------------|

| ● | original |

| ◐ | forked & modified |

| ○ | republished unmodified |

## Quick start

```bash

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:

```bash

pi -e git:github.com/w-winter/dot314

```

## Installation

### Install as a Pi package

**Requires Pi 0.63.1+** (see [packages.md](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/packages.md))

Install from git:

```bash

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`):

```bash

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:

```json

{

  "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](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/packages.md#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//...` (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](#included-in-the-pi-package)).  They can be installed with:

```bash

pi install npm:

```

For example, `pi install npm:pi-repoprompt-mcp`.

See [`packages/`](packages/) for all available npm packages.

---

## Extensions

See [extensions/README.md](extensions/README.md) for more detailed descriptions.

### Included in the Pi package

| | Extension | npm | Description |

|---|---|---|---|

| ● | `anycopy/` | [`pi-anycopy`](https://www.npmjs.com/package/pi-anycopy) | `/tree` with live syntax-highlighted preview + copy |

| ◐ | `branch-out/` | [`pi-branch-out`](https://www.npmjs.com/package/pi-branch-out) | Fork session into split pane or new tab with layout policies and optional model/message queuing |

| ● | `brave-search/` | [`pi-brave-search`](https://www.npmjs.com/package/pi-brave-search) | Web search + content extraction. 🔄 Consider [pi-web-access](https://github.com/nicobailon/pi-web-access) for general-purpose search |

| ◐ | `cmux/` | | cmux sidebar integration + workspace auto-renaming; no-op outside cmux |

| ● | `command-center/` | [`pi-command-center`](https://www.npmjs.com/package/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`](https://www.npmjs.com/package/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`](https://www.npmjs.com/package/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`](https://www.npmjs.com/package/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`](https://www.npmjs.com/package/pi-md-export) | Export session branch or last N turns to Markdown file or clipboard |

| ● | `model-aware-compaction/` | [`pi-model-aware-compaction`](https://www.npmjs.com/package/pi-model-aware-compaction) | Per-model compaction thresholds |

| ● | `model-sysprompt-appendix/` | [`pi-model-sysprompt-appendix`](https://www.npmjs.com/package/pi-model-sysprompt-appendix) | Per-model system prompt additions |

| ● | `move-session.ts` | [`pi-move-session`](https://www.npmjs.com/package/pi-move-session) | Move current active session to a new cwd |

| ◐ | `oracle.ts` | | Second opinion from alternate model |

| ◐ | `plan-mode.ts` | [`pi-plan-modus`](https://www.npmjs.com/package/pi-plan-modus) | Read-only planning sandbox with RepoPrompt support |

| ● | `poly-notify/` | [`pi-poly-notify`](https://www.npmjs.com/package/pi-poly-notify) | Desktop / sound / Pushover notifications |

| ● | `protect-paths.ts` | | Directory protection, brew prevention, command gates. 🔄 Pair with [`@aliou/pi-guardrails`](https://github.com/aliou/pi-guardrails) for `.env` + AST gates |

| ● | `repoprompt-mcp/` | [`pi-repoprompt-mcp`](https://www.npmjs.com/package/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`](https://www.npmjs.com/package/pi-roam) | Post-hoc tmux handoff for remote continuation of sessions |

| ● | `rp-native-tools-lock/` | [`pi-repoprompt-tools-lock`](https://www.npmjs.com/package/pi-repoprompt-tools-lock) | Prefer RP tools over Pi native tools |

| ◐ | `sandbox/` | | OS-level sandboxing |

| ● | `session-ask/` | [`pi-session-ask`](https://www.npmjs.com/package/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 |

| ◐ | `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-shell.ts` |

| ○ | `interactive-shell.ts` |

| ○ | `pi-prompt-template-model/` |

| ○ | `preset.ts` |

| ● | `repoprompt-cli/` |

| ◐ | `rewind/` — archived; use upstream [`pi-rewind-hook`](https://github.com/nicobailon/pi-rewind-hook) |

| ○ | `skill-palette/` |

| ● | `skill-templates/` |

| ● | `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](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/examples/extensions/bookmark.ts) (badlogic) | `/bookmark ` to label the last message in the session tree | Copy to `~/.pi/agent/extensions/` |

| [diff](https://github.com/badlogic/pi-mono/blob/main/.pi/extensions/diff.ts) (badlogic) | `/diff` shows git-changed files and opens selected file in VS Code's diff view | Copy to `~/.pi/agent/extensions/` |

| [diligent-pi](https://github.com/crstdr/diligent-pi) (crstdr) | `/diligent-context` hides past tool calls from the context, a useful alternative to compaction in some types of sessions |  |

| [greprip](https://github.com/kaofelix/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](https://github.com/kaofelix/greprip#2-configure-pi) |

| [loop](https://github.com/mitsuhiko/agent-stuff/blob/main/pi-extensions/loop.ts) (mitsuhiko) | `/loop` starts a follow-up loop with a breakout condition | Copy to `~/.pi/agent/extensions/` |

| [pi-gpt-config](https://github.com/edxeth/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](https://github.com/aliou/pi-guardrails) (aliou) | `.env` file protection + AST-based dangerous command gates | `pi install npm:@aliou/pi-guardrails` |

| [pi-interactive-subagents](https://github.com/HazAT/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](https://github.com/nicobailon/pi-intercom) (nicobailon) | Direct 1:1 messaging between Pi sessions; augments subagents nicely | `pi install npm:pi-interview` |

| [pi-interview](https://github.com/nicobailon/pi-interview-tool) (nicobailon) | Interactive form-based input gathering with native window support | `pi install npm:pi-interview` |

| [pi-nvim](https://github.com/aliou/pi-harness/tree/main/integrations/neovim) (aliou) | Bidirectional Neovim integration: `nvim_context` tool, LSP diagnostics at turn end, file reload after edits, visible-splits injection | Neovim plugin; see [setup instructions](https://github.com/aliou/pi-harness/tree/main/integrations/neovim#installation) |

| [pi-rtk-optimizer](https://github.com/MasuRii/pi-rtk-optimizer) (MasuRii) | Read-tool-kit context optimization for token efficiency | `pi install npm:pi-rtk-optimizer` |

| [pi-screenshots-picker](https://github.com/Graffioh/pi-screenshots-picker) (Graffioh) | Quick screenshot selection and attachment for prompts | `pi install npm:pi-screenshots-picker` |

| [pi-token-burden](https://github.com/Whamp/pi-token-burden) (Whamp) | Token usage breakdown and context burden analysis | `pi install npm:pi-token-burden` |

| [pi-tool-display](https://github.com/MasuRii/pi-tool-display) (MasuRii) | Compact tool call rendering with diff visualization | `pi install npm:pi-tool-display` |

| [pi-web-access](https://github.com/nicobailon/pi-web-access) (nicobailon) | Gemini-powered web search with AI-synthesized overviews and citations | `pi install npm:pi-web-access` |

| [whimsical](https://github.com/mitsuhiko/agent-stuff/blob/main/pi-extensions/whimsical.ts) (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](skills/README.md) for full descriptions.

| | Skill | Notes |

|---|---|---|

| ○ | `agent-browser/` | |

| ◐ | `dev-browser/` | 🔄 Prefer [surf/](skills/surf/) for browsing/scraping, [agent-browser/](skills/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](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](AGENTS-prefaces/README.md)

| | Preface |

|---|---|

| ● | `AGENTS-prefaces/rp-cli-preface.md` |

| ● | `AGENTS-prefaces/rp-mcp-preface.md` |

| ● | `AGENTS-prefaces/rp-mcp-preface-exPi.md` |
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/w-winter/dot314

Awesome Lists containing this project

README
