pi-extensions

简体中文

A collection of Pi extensions by zhcsyncer.

Packages

• @zhcsyncer/pi-recap — recent activity recap extension with optional session title and tmux window sync.
• @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 — maintained fork of @juicesharp/rpiv-todo with a persistent task overlay and no duplicate successful tool nodes.
• @zhcsyncer/pi-search-hub — bundle-private web_search and web_read tools integrated with intent-aware rendering.

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.

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

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-search-hub --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-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.