@zhcsyncer/pi-extensions

A collection of Pi extensions by zhcsyncer.

Packages

Package details

extensionskill

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

npm repo home report

$ pi install npm:@zhcsyncer/pi-extensions

Package: @zhcsyncer/pi-extensions
Version: 0.24.0
Published: Aug 18, 2026
Downloads: 4,607/mo · 1,172/wk
Author: zhcsyncer
License: MIT
Types: extension, skill
Size: 3 MB
Dependencies: 6 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./packages/pi-recap/extensions/recap.ts",
    "./packages/pi-tool-display-intent/extensions/tool-display-intent.ts",
    "./packages/pi-todo/index.ts",
    "./packages/pi-glance/index.ts",
    "./packages/pi-plan-mode/extensions/plan-mode.ts",
    "./packages/pi-search-hub/extensions/search-hub.ts",
    "./packages/pi-context7/extensions/context7.ts",
    "./packages/pi-ask-user-question/index.ts",
    "./packages/pi-subagents/src/index.ts",
    "./packages/pi-fast-mode/extensions/fast-mode.ts",
    "./packages/pi-meter/extensions/meter.ts"
  ],
  "skills": [
    "./packages/pi-context7/skills"
  ],
  "image": "https://raw.githubusercontent.com/zhcsyncer/pi-extensions/main/packages/pi-glance/assets/demo.png"
}

Security note

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

README

pi-extensions

简体中文

A collection of Pi extensions by zhcsyncer.

Packages

@zhcsyncer/pi-recap — recent activity recap extension with optional session title and nearest-layer Herdr pane or tmux window naming.
@zhcsyncer/pi-tool-display-intent — compact tool rendering with model-written intent phrases, RPC-visible summaries, an optional all-tool per-request Tools summary, stable done rows, adaptive diffs, and bounded Bash call previews.
@zhcsyncer/pi-todo — cycle-bounded task overlay with atomic multi-item batches, confirmed /todo reset, and no dependency graph; live lists stay on active work across compaction and resume.
@zhcsyncer/pi-glance — maintained pi-glance fork with composable statuses, a single-slot editor stash, working-tree counts in the Git status line or bottom-right border, /diff review, and a theme-aware Claude-inspired working indicator.
@zhcsyncer/pi-plan-mode — strict read-only planning with revdiff review, immutable revisions, compact audit rendering, and an explicit branch-aware implementation/completion lifecycle.
@zhcsyncer/pi-search-hub — bundle-private web_search and web_read tools integrated with intent-aware rendering.
@zhcsyncer/pi-context7 — Context7 resolve-library-id / query-docs tools with compact self-contained TUI rendering and the full context7-docs skill.
@zhcsyncer/pi-ask-user-question — structured clarification questions with a non-overlay layout, context-aware number-key selection, centered previews, and readable post-interaction results.
@zhcsyncer/pi-herdr-companion — Herdr integration with cross-workspace managed-process identity, a navigable Process Widget, compact tool rendering, temporary /btw side threads, blocked status, and unified settings. Install it separately; the root bundle does not enable it.
@zhcsyncer/pi-subagents — maintained fork of @tintinweb/pi-subagents with a brief ConversationViewer and collapsible tool TUI (model/effort chips). Also embedded in the root bundle.
@zhcsyncer/pi-fast-mode — same-model Fast / Priority scheduling for OpenAI and xAI, with an in-memory /fast and Ctrl+F switch.
@zhcsyncer/pi-meter — local spend plus Claude / Codex / SuperGrok / Ollama Cloud remaining in one /usage command. Combines pi-tracker and @pi-plugins/usage; disable the latter because both register /usage.

Notes

Search Hub ships only in the root bundle. Do not load @tintinweb/pi-subagents with pi-subagents, or @pi-plugins/usage with pi-meter.

Install from Git

Install the whole extension bundle from this repository:

pi install git:github.com/zhcsyncer/pi-extensions

Try without installing:

pi -e git:github.com/zhcsyncer/pi-extensions

Install from npm

Install the complete bundle, including Glance, Plan Mode, Context7, Subagents, Fast Mode, Meter, structured user questions, and the private Search Hub fork:

pi install npm:@zhcsyncer/pi-extensions

Install only recap:

pi install npm:@zhcsyncer/pi-recap

Install only the intent-aware tool display:

pi install npm:@zhcsyncer/pi-tool-display-intent

Install only Todo:

pi install npm:@zhcsyncer/pi-todo

Install only Glance:

pi install npm:@zhcsyncer/pi-glance

Install only strict Plan Mode:

pi install npm:@zhcsyncer/pi-plan-mode

Install only Context7 documentation tools:

pi install npm:@zhcsyncer/pi-context7

Install only structured user questions:

pi install npm:@zhcsyncer/pi-ask-user-question

Install the standalone Herdr companion (not auto-enabled by the root bundle):

pi install npm:@zhcsyncer/pi-herdr-companion

Install only Subagents:

pi install npm:@zhcsyncer/pi-subagents

Install only Fast Mode:

pi install npm:@zhcsyncer/pi-fast-mode

Install only Meter:

pi install npm:@zhcsyncer/pi-meter

Releasing

Add a changeset to each user-facing pull request:

pnpm changeset

Public packages version independently. A changed child package must include the aggregate root package in the same release plan because the root tarball embeds child sources; unchanged siblings do not release. Before pushing a release-bearing change, present the planned packages and target versions for user review. After approved changes land on main, GitHub Actions opens a version PR, and merging that reviewed PR publishes the planned packages and creates their GitHub Releases. See RELEASING.md for the complete workflow and one-time npm/GitHub setup.

License

MIT

pi-tool-display-intent is a modified fork of MIT-licensed MasuRii/pi-tool-display 0.5.0 and adapts the MIT-licensed displaySummary mechanism from mertdeveci5/pi-tool-display-summary 0.1.0. Full attribution and preserved notices are in packages/pi-tool-display-intent/README.md, LICENSE, and UPSTREAM_LICENSE.

pi-todo is forked from MIT-licensed @juicesharp/rpiv-todo 1.20.0. The exact revision and preserved notices are recorded in packages/pi-todo/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.

pi-glance is forked from MIT-licensed LinYS77/pi-glance 0.5.3. The exact revision and preserved notices are recorded in packages/pi-glance/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.

pi-search-hub is forked from ronnieops/pi-search-hub 2.8.0, whose package metadata and README declare MIT. Its exact revision and preserved notices are recorded in packages/pi-search-hub/UPSTREAM_SOURCE.md and UPSTREAM_NOTICE.md.

pi-context7 is forked from MIT-licensed @upstash/context7-pi 0.1.2 (b250c2515694eee4b6df4db82fa056df9ed3e306). The exact revision and preserved notices are recorded in packages/pi-context7/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.

pi-ask-user-question is forked from MIT-licensed @juicesharp/rpiv-ask-user-question 2.4.0. The exact revision and preserved notices are recorded in packages/pi-ask-user-question/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.

pi-subagents is forked from MIT-licensed @tintinweb/pi-subagents 0.14.3 (c10b1836256e760da75296ccd4e57a77ada1325e). The exact revision, local UI deltas, and preserved notices are recorded in packages/pi-subagents/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.

pi-herdr-companion adapts /btw behavior and private mailbox patterns from MIT-licensed pi-herdr-btw 0.3.0. The exact tarball provenance and preserved notice are recorded in packages/pi-herdr-companion/UPSTREAM_SOURCE.md, LICENSE, and UPSTREAM_LICENSE.