pi-ext

A practical extension pack for Pi: command palettes, code review, session workflows, terminal integrations, compact UI, skills, and a theme.

Install

pi install npm:@iurysza/pi-ext

Restart Pi or run /reload after installation.

To load only selected resources, filter the package in settings.json:

{
  "packages": [
    {
      "source": "npm:@iurysza/pi-ext",
      "extensions": [
        "extensions/leader-key/index.ts",
        "extensions/review/review.ts"
      ],
      "skills": ["skills/sem"]
    }
  ]
}

Omit a resource type to load all of it. Use an empty array to load none.

Extensions

| Extension | Description | | --- | --- | | Leader Key | Ctrl+X command palette for sessions, models, thinking levels, labels, and extension commands. | | Code Review | /review workflows for pull requests, branches, commits, and uncommitted changes. | | pi-sem | Entity-aware Git diff, context, history, blame, and impact tools powered by sem. | | Pi Telescope | Native fuzzy finder for sessions, files, commands, and other providers. | | Custom Footer | Compact status line with Git, token, context, timing, and model information. | | Tool Pills | Compact tool labels, collapsible output, and highlighted write/edit diffs. | | Permissions | Switchable yolo, safe, and read-only command policies. | | Session Query | Ask focused questions about previous Pi session files. | | Session Store | Search indexed session history with /search. | | Session Snap | Review, archive, restore, and remove old sessions. | | Handoff | Transfer compacted context to a fresh Pi session. | | Split Fork | Fork the current session into a tmux, cmux, or Herdr split or tab. | | Ask User | Structured single- or multi-select questions with an interactive Pi UI. | | cmux | Notifications, status, browser, and workspace integration for cmux. | | Superconductor | Worktree status and controls when Pi runs under Superconductor. |

Leader Key

Press Ctrl+X to open the palette. Actions are grouped by single-character keys and include model switching, favourite models, thinking level, session operations, labels, extension commands, and workflow shortcuts.

Favourite model presets live in extensions/leader-key/favourite-models.json. Optional display roles live in extensions/leader-key/model-nicknames.json.

Permissions

Use /mode to switch policy:

• yolo allows every command.
• safe applies rules and asks about unknown shell commands.
• read-only blocks repository and home-directory writes.

Rules merge from project .agents/permissions.json, global ~/.pi/agent/permissions.json, and built-ins.

Review and semantic tools

/review can inspect a GitHub pull request, compare against a base branch, review uncommitted changes, inspect one commit, or follow custom instructions. Projects can add REVIEW_GUIDELINES.md.

When pi-sem is loaded, review agents can use:

• sem_diff for changed entities;
• sem_impact for dependents and affected tests;
• sem_context for focused function or class context;
• sem_log, sem_entities, and sem_blame for history and ownership; and
• sem_eval to compare semantic and raw Git diff coverage.

The optional @ataraxy-labs/sem dependency installs automatically when the platform supports it. You can also install sem with Homebrew or Cargo.

Session workflows

• /snap reviews old sessions before archiving or deleting them.
• /archive browses archived sessions for restore or permanent removal.
• /handoff [--tab] <goal> starts a fresh session with compacted context.
• /split-fork [--tab] forks into Herdr, tmux, or cmux.
• /search searches the local session index.

Multiplexer integrations stay quiet when their host application is absent.

Skills

| Skill | Description | | --- | --- | | commit | Create concise Conventional Commit messages from the current diff. | | github | Work with issues, pull requests, and CI through gh. | | pr-review-comments | Triage and resolve pull-request review comments. | | sem | Apply entity-aware context and impact analysis during code review. | | session-query | Recover decisions and details from previous Pi sessions. | | visit-webpage | Extract readable Markdown or download an image from a URL. | | web-search | Search the web through Jina without opening a browser. |

Theme

Catppuccin Mocha provides a dark Pi theme based on the Catppuccin palette.

Requirements

• Pi
• Node.js 22.19 or newer
• Optional host tools only for their matching integrations: gh, sem, Herdr, tmux, cmux, or Superconductor

License

MIT © 2025 tomsej, © 2026 Iury Souza. This package derives from tomsej/pi-ext; component attribution remains in THIRD_PARTY_NOTICES.md.