A collection of extensions for the pi coding agent.
| Module | Type | Install Command | Config Key |
|---|---|---|---|
| background-notify | hook | npm run install:background-notify |
backgroundNotify |
| session-emoji | hook | npm run install:session-emoji |
sessionEmoji |
| session-color | hook | npm run install:session-color |
sessionColor |
| safe-git | extension | npm run install:safe-git |
safeGit |
| pi-agent-scip | extension | npm run install:pi-agent-scip |
N/A |
Get notified when long-running tasks complete while your terminal is in the background. Plays an audio beep and brings the terminal to front (macOS).
Commands: /notify, /notify-test, /notify-beep, /notify-focus, /notify-config, /notify-status
npm run install:background-notifyDisplay an intelligent emoji in pi's footer that represents your conversation. Uses AI to analyze context and pick a relevant emoji, with 24-hour uniqueness to avoid repetition.
Commands: /emoji, /emoji-set, /emoji-config, /emoji-history
npm run install:session-emojiDisplay a colored band in pi's footer to visually distinguish sessions. Uses a 40-color palette designed for maximum visual distinction between consecutive sessions.
Commands: /color, /color-set, /color-next, /color-config
npm run install:session-colorRequire explicit user approval before dangerous git operations. High-risk operations (force push, hard reset) show warnings; medium-risk (push, commit) require confirmation. Blocks entirely in non-interactive mode.
Commands: /safegit, /safegit-status, /safegit-level
npm run install:safe-gitSCIP code intelligence tools for Python and TypeScript/JavaScript projects. Provides fast, compiler-accurate navigation (go to definition, find references, list/search symbols, project tree) using Sourcegraph's SCIP indexers.
Tools: scip_find_definition, scip_find_references, scip_list_symbols, scip_search_symbols, scip_project_tree
npm run install:pi-agent-scip# Install everything
npm run install:all
# Or install individually
npm run install:background-notify
npm run install:session-emoji
npm run install:session-color
npm run install:safe-gitRestart pi after installing for modules to load.
| Topic | Location |
|---|---|
| Installation guide | docs/INSTALL.md |
| Module overview | docs/SUMMARY.md |
| Release checklist | docs/RELEASE.md |
| Troubleshooting tips | docs/troubleshooting.md |
| Contributing guide | CONTRIBUTING.md |
Have questions or ideas? Open an issue or submit a PR.
npm run test:e2e # Run E2E tests (requires pi + tmux)
npm run test:e2e:watch # Watch mode
npm run typecheck # TypeScript checknpm run uninstall:all # Remove everything
npm run uninstall:all-extensions # Remove all extensions- pi coding agent v0.36.0+
- Node.js 20+
- macOS (for background-notify terminal activation)
MIT