@iurysza/pi-ext

An attributed fork of tomsej/pi-ext with additional Pi workflows and integrations.

Packages

Package details

extensionskilltheme

Install @iurysza/pi-ext from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@iurysza/pi-ext

Package: @iurysza/pi-ext
Version: 0.1.0
Published: Jul 24, 2026
Downloads: 131/mo · 36/wk
Author: iurysza
License: MIT
Types: extension, skill, theme
Size: 628.9 KB
Dependencies: 5 dependencies · 5 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/custom-footer/custom-footer.ts",
    "./extensions/review/review.ts",
    "./extensions/leader-key/index.ts",
    "./extensions/permissions/permissions.ts",
    "./extensions/session-query/session-query.ts",
    "./extensions/ask-user-question/index.ts",
    "./extensions/tool-pills/index.ts",
    "./extensions/split-fork/index.ts",
    "./extensions/superconductor/index.ts",
    "./extensions/session-store/index.ts",
    "./extensions/cmux/index.ts",
    "./extensions/handoff/index.ts",
    "./extensions/session-snap/index.ts",
    "./extensions/pi-telescope/index.ts",
    "./extensions/pi-sem/index.ts"
  ],
  "skills": [
    "./skills/commit",
    "./skills/github",
    "./skills/visit-webpage",
    "./skills/web-search",
    "./skills/session-query",
    "./skills/sem",
    "./skills/pr-review-comments"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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