@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: 1.0.2
Published: Sep 24, 2026
Downloads: 3,963/mo · 539/wk
Author: zhcsyncer
License: MIT
Types: extension, skill
Size: 3.4 MB
Dependencies: 6 dependencies · 3 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/zhcsyncer/pi-extensions/main/packages/pi-glance/assets/demo.png",
  "skills": [
    "./packages/pi-context7/skills"
  ],
  "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",
    "./packages/pi-consult/extensions/consult.ts"
  ]
}

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 — unified web_search and web_read across Exa, Tavily, Firecrawl, Parallel, Codex, and Grok. Also embedded in the root bundle.
@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-adversarial-review — deterministic multi-model adversarial code review. Install it separately; the root bundle does not include it.
@zhcsyncer/pi-fast-mode — same-model Fast / Priority scheduling for OpenAI and xAI, with a per-model in-memory /fast and Ctrl+F switch.
@zhcsyncer/pi-consult — second-opinion consult({ why }) with a watchdog, an optional dual-path panel, and a local behavior log. Unconfigured, it unloads itself.
@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. Adversarial Review is published independently and is not included in the root bundle. Do not load @tintinweb/pi-subagents with pi-subagents, or @pi-plugins/usage with pi-meter.

Requires Pi 0.86 or later. Fast Mode, Consult, Subagents, and the standalone Cursor and Volcengine providers in this repo follow the 0.86 transcript (system text and tools live on the conversation).

Standalone providers

These providers are not included in the root bundle and release independently.

pi-provider-cursor-ask — a full @rahularya01/pi-cursor replacement that keeps the cursor provider/login identity and maps only a curated subset of models: six 1M Fable/Opus/Sonnet rows (including Opus 5.5), Composer 2.5 / Fast, and Grok 4.6 / Fast when the live catalog includes them.
pi-provider-volcengine-agent-plan — an unofficial Volcengine Ark Agent Plan provider with tier-aware models and Pi login.

pi install npm:pi-provider-cursor-ask

pi install npm:pi-provider-volcengine-agent-plan

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, Consult, 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 the standalone adversarial review extension (not included in the root bundle):

pi install npm:@zhcsyncer/pi-adversarial-review

Install only Fast Mode:

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

Install only Meter:

pi install npm:@zhcsyncer/pi-meter

Install only Consult:

pi install npm:@zhcsyncer/pi-consult

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.

pi-provider-cursor-ask is forked from MIT-licensed @rahularya01/pi-cursor 1.4.25 (5f8e775279f5e41cdd06791a036be4c7141097c3). Its exact revision, standalone identity and catalog differences, and preserved notice are recorded in providers/pi-provider-cursor-ask/UPSTREAM_SOURCE.md and LICENSE.