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, adaptive diffs, and bounded Bash call previews.
• @zhcsyncer/pi-todo — branch-aware task overlay with strict lifecycle rules, atomic batches, isolated SDK session state, and expandable audit summaries.
• @zhcsyncer/pi-glance — maintained pi-glance fork with composable extension statuses, bottom-right context progress, and a highlighted auto-compaction marker.
• @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.

Bundle-private Search Hub

The aggregate @zhcsyncer/pi-extensions package includes the private Search Hub fork and registers its web_search and web_read tools. Search Hub is not published as a standalone npm package; install the root bundle to use it.

This fork keeps upstream multi-backend search and page extraction while integrating model-written displaySummary intents, semantic query/URL call lines, backend and reader status, and the shared tool-display result modes. See the Search Hub documentation or its Simplified Chinese version for configuration and local behavior.

Context7

@zhcsyncer/pi-context7 is a maintained fork of Context7 documentation tools. It can be installed on its own or used through the root bundle, which embeds and registers the same extension and skill.

This fork keeps upstream tool descriptions, model-facing result text, and the full skill while adding compact local renderCall / renderResult rows, AbortSignal-aware fetches, and HTTP error throwing for correct Pi tool-error marking. Set CONTEXT7_API_KEY for higher quotas. See the Context7 documentation or its Simplified Chinese version.

Persistent extension data

Bundle extension configuration and state live under $PI_CODING_AGENT_DIR/extension-data/<extension-id>/. Existing files are migrated and upgraded automatically; unmappable fields are dropped with a warning, while malformed source files are preserved. Trusted project overrides for Recap and Search Hub use .pi/extension-data/<extension-id>/config.json. Plan artifacts intentionally remain in $PI_CODING_AGENT_DIR/plans/.

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, 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

Development

Test the root bundle:

pi -e . --list-models nope

Test a package directly:

pi -e ./packages/pi-recap --list-models nope
pi --no-extensions -e ./packages/pi-tool-display-intent
pi --no-extensions -e ./packages/pi-todo --list-models nope
pi --no-extensions -e ./packages/pi-glance
pi --no-extensions -e ./packages/pi-plan-mode --list-models nope
pi --no-extensions -e ./packages/pi-search-hub --list-models nope
pi --no-extensions -e ./packages/pi-context7 --list-models nope

When testing pi-tool-display-intent, do not load the original pi-tool-display or pi-tool-display-summary at the same time because all three can own the same built-in tool names.

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.