Skip to content

Karrq/dot314

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

134 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

.Ο€

Extensions, skills, prompts, and themes for Pi coding agent. There is an emphasis here on making Pi and RepoPrompt co-operate well.

This is a personal collection. Some items are original, some adapted from the Pi community, some used unadapted. It's tailored to my workflow and may introduce breaking changes without notice. Unadapted items may lag well behind their upstream versions. Extensions published as Pi packages receive more careful maintenance.

Provenance key

  • ● β†’ new
  • ◐ β†’ from Pi community, modified
  • β—‹ β†’ from Pi community, 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 - for example:

{
  "packages": [
    {
      "source": "git:github.com/w-winter/dot314",
      "extensions": [
        "extensions/repoprompt-mcp/src/index.ts",
        "extensions/rp-native-tools-lock/index.ts",
        "extensions/session-ask/index.ts",
        "extensions/vog/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 ... 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

If you only want one extension, you can install the per-extension npm packages (see packages/ in this repo).

Example:

pi install npm:pi-repoprompt-cli

All available npm packages:

npm package Extension
pi-brave-search brave-search
pi-command-center command-center
pi-ephemeral ephemeral-mode
pi-fork-from-first fork-from-first
pi-md-export md
pi-model-aware-compaction model-aware-compaction
pi-model-sysprompt-appendix model-sysprompt-appendix
pi-move-session move-session
pi-plan-modus plan-mode
pi-poly-notify poly-notify
pi-repoprompt-cli repoprompt-cli
pi-repoprompt-mcp repoprompt-mcp
pi-repoprompt-tools-lock rp-native-tools-lock
pi-session-ask session-ask
pi-voice-of-god vog

What the Pi package includes

This repo contains more resources than the package exports. When installed as a Pi package, Pi will discover only the resources declared in package.json:

Extensions

Extension Notes
◐ agentic-compaction/ Summarizer explores conversation as a filesystem
● brave-search/ Web search + content extraction. Requires BRAVE_API_KEY. πŸ”„ Consider pi-web-access for general-purpose agent search
● command-center/ /command palette widget
◐ editor-enhancements/ File picker, shell completions, raw paste
● ephemeral-mode.ts Delete session on exit
● fork-from-first.ts Quickly fork session from first message
◐ handover/ Generate handover draft -> fork-from-first -> prefill editor (default to conversation-only fork if coinstalled with rewind/)
● md.ts Export session or last N turns to Markdown
● model-aware-compaction/ Per-model compaction thresholds
● model-sysprompt-appendix/ Per-model system prompt additions
● move-session.ts Move session to a different cwd
◐ oracle.ts Second opinion from alternate model
◐ plan-mode.ts Read-only planning sandbox
● poly-notify/ Desktop / sound / Pushover notifications
● protect-paths.ts Directory protection, brew prevention, extra command gates. πŸ”„ Replaces the path/brew hooks from old guardrails/; install @aliou/pi-guardrails for .env protection + AST-based dangerous command gates
● repoprompt-cli/ RepoPrompt bridge via rp-cli
● repoprompt-mcp/ RepoPrompt MCP proxy with binding + rendering
● rp-native-tools-lock/ Prefer RP tools over Pi native tools
◐ sandbox/ OS-level sandboxing
● session-ask/ Query session history via subagent
◐ session-switch.ts /resume-style session picker (via /switch-session), with live background preview of selected session
◐ tools/ Interactive tool enable/disable
◐ usage-bar.ts Provider quota overlay
● vog/ Inject custom system prompt message

Themes

Theme
● themes/violet-dawn.json
● themes/violet-dusk.json

Manual / symlink setup

If you prefer a local working-copy workflow, clone this repo anywhere:

git clone --recurse-submodules git@github.com:w-winter/dot314.git ~/path/to/dot314-agent

Then symlink what you want into ~/.pi/agent/:

# Example: add one extension (single-file)
ln -s ~/path/to/dot314-agent/extensions/move-session.ts ~/.pi/agent/extensions/

# Example: add all skills from this repo
ln -s ~/path/to/dot314-agent/skills/* ~/.pi/agent/skills/

Pi scans ~/.pi/agent/extensions/, skills/, and prompts/ for resources.


Everything in this repo

The sections below list all resources in this repository, including items not exported by the Pi package.

Extensions

See extensions/README.md for full descriptions.

Extension
◐ agentic-compaction/
◐ branch-term.ts
● brave-search/
β—‹ code-actions/
● command-center/
● dedup-agents-files.ts
◐ editor-enhancements/
● ephemeral-mode.ts
● fork-from-first.ts
◐ handover/
β—‹ inline-bash.ts
β—‹ interactive-shell.ts
β—‹ mac-system-theme.ts
● md.ts
● model-aware-compaction/
● model-sysprompt-appendix/
● move-session.ts
◐ oracle.ts
β—‹ pi-prompt-template-model/
◐ plan-mode.ts
● poly-notify/
β—‹ preset.ts
● protect-paths.ts
β—‹ questionnaire.ts
● repoprompt-cli/
● repoprompt-mcp/
β—‹ review.ts
◐ rewind/
● rp-native-tools-lock/
◐ sandbox/
β—‹ send-user-message.ts
● session-ask/
◐ session-switch.ts
◐ skill-palette/
β—‹ speedreading.ts
β—‹ status-line.ts
β—‹ subagent/
β—‹ titlebar-spinner.ts
β—‹ todos.ts
◐ tools/
◐ ultrathink.ts
◐ usage-bar.ts
● vog/

Skills

The Pi package does not export any skills. The skills in this repo are intended for local/symlink workflows.

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
β—‹ handoff.md
β—‹ pickup.md
● 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

Themes

Theme
● violet-dawn.json
● violet-dusk.json

About

Extensions, commands, themes for Pi

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 79.6%
  • JavaScript 15.3%
  • Python 2.9%
  • Shell 2.2%