---
slug: "ogulcancelik-pi-herdr"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ogulcancelik/pi-extensions@main/README.md"
repo: "https://github.com/ogulcancelik/pi-extensions"
source_file: "README.md"
branch: "main"
---
# pi extensions

Extensions for [pi](https://github.com/earendil-works/pi), the terminal-based coding agent.

This is my working collection rather than a single polished suite. Some extensions are part of my daily setup, some are occasional tools, and others are experiments I may change or stop using. The table is sorted roughly by how actively I use them.

| Package | Description | Usage |
|---------|-------------|-------|
| [pi-minimal-footer](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-minimal-footer) | Minimal footer with context gauge and subscription usage bars | 🔥 Core |
| [pi-session-recall](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-session-recall) | Search and query past sessions — "remember when we tried X?" | 🔥 Core |
| [pi-auto-permissions](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-auto-permissions) | Context-aware Bash permissions with automated guardian review | 🟢 Active |
| [pi-codex-subagents](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-codex-subagents) | Codex-shaped, session-scoped subagents with templates, waits, steering, and a live overlay | 🟢 Active |
| [pi-codex-compaction](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-codex-compaction) | OpenAI Codex native remote compaction through Pi's existing compaction lifecycle | 🟢 Active |
| [pi-handoff](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-handoff) | Transfer context to a new session with full briefing | 🟡 Moderate+ |
| [pi-quit-and-delete](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-quit-and-delete) | Keyboard shortcut to quit pi and permanently delete the active session file | 🟠 Moderate |
| [pi-ssh-tools](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-ssh-tools) | Toggle explicit SSH tools on demand via `/ssh` without replacing local tools | 🟠 Moderate |
| [pi-fork-plus](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-fork-plus) | Fork from the session tree, including editable assistant-message forks | 🧪 Experimental |
| [pi-herdr](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-herdr) | Pi-native tools for Herdr layouts, terminal panes, and coding agents | 🧪 Experimental |
| [pi-model-agents](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-model-agents) | Load model-specific AGENTS.md instructions based on the active pi model | 🧪 Experimental |
| [pi-model-thinking](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-model-thinking) | Auto-set and remember thinking levels per model | 🧪 Experimental |
| [pi-ghost](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-ghost) | Ephemeral side conversation overlay — open a temporary ghost session inside the current pi UI | ⚪ Very rare |
| [pi-ghostty-theme-sync](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-ghostty-theme-sync) | Sync pi theme with Ghostty terminal colors | ⚪ Very rare |
| [pi-goal](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-goal) | Break work into tasks, spawn parallel worker agents | ⚪ Very rare |
| [pi-sketch](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-sketch) | Visual sketching in the terminal | ⚪ Very rare |
| [pi-tmux](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-tmux) | Tmux pane management — largely superseded by Herdr | ⚪ Very rare |
| [pi-worktree](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-worktree) | Relocate the active pi session to a git worktree while preserving conversation history | ⚪ Very rare |
| [pi-web-browse](https://github.com/ogulcancelik/pi-extensions/tree/HEAD/packages/pi-web-browse) | Deprecated — use [agent-skills](https://github.com/ogulcancelik/agent-skills) for web browsing | ⛔ Deprecated |

## Install

```bash
pi install npm:@ogulcancelik/<package-name>
```

See each package's README for setup and usage.