$ cat ~/map/pi-extensions-zion.md

pi-extensions (zion-zion-zion)

Chinese-documented pi extension pack installing as one npm package: token speed, Codex quota, Git helpers, Herdr utilities.

extensions✓ Sep 15

pi install npm:@zionzionzion/pi-extensions (update with pi update; or copy individual .ts files to ~/.pi/agent/extensions/ and run /reload — the codex-usage and reload-all directory extensions need their whole folders, and the two .json config files stay manual copies)

## TL;DR

A Chinese-language collection of pi extensions and one skill, published as a single npm package: a token-speed footer widget, a ChatGPT Codex quota display, /commits and /checkpoint Git helpers, a model filter, and Herdr pane utilities.

## Key points

• $Single-package distribution: pi install npm:@zionzionzion/pi-extensions brings every extension plus the read-terminal skill in one command, and pi update refreshes them; the npm release itself is automated by GitHub Actions whenever a version bump lands on main (tests, then npm publish, then a v* tag).
• $Measurement and model-list pieces: token-speed shows the previous answer's generation speed in tok/s as a pi-footer widget, with /speed for detailed statistics; codex-usage (a directory extension whose whole folder must be installed) shows the ChatGPT Codex five-hour and weekly quotas at /status with a footer summary, reusing the openai-codex OAuth that pi manages; model-filter hides unused historical models from built-in providers (openai-codex gpt-5.3 through 5.5 by default) in /model and --list-models.
• $Git helpers: /commits lists the current branch's commit history and runs git show --stat on the selected entry; /checkpoint generates a commit message and commits the current changes, and never pushes.
• $Herdr-scoped utilities: auto-hide-thinking, reload-all, and the read-terminal skill act on Herdr's named panes — auto-hide-thinking takes the pane's own hideThinkingBlock as its baseline (settings.json is shared by all panes and can serve only as a fallback) and injects Ctrl+T via herdr pane send-keys, hiding both thinking and whole tool blocks once a turn ends, with the injected Ctrl+T restoring both; it is a no-op outside Herdr and in print and RPC modes; reload-all re-loads every idle pi window in Herdr, skipping busy ones and windows with a draft in the input; read-terminal reads another named pane's screen or scrollback, read-only.
• $Fullscreen and keyboard utilities: scroll-to-last-prompt (tuiMode fullscreen only) pins the previous message's first line to the top of the screen after each turn, marking the first rendered line of UserMessageComponent instead of scanning OSC 133;A because plain-text assistant messages carry the same prefix, and it restores follow-scroll on the next sent message after a manual scroll (messages queued with alt+enter excepted); steer-or-interrupt maps Opt+Enter to immediately interrupting and sending when no tool is pending, and to built-in steering otherwise.
• $The .ts extensions import @earendil-works/pi-coding-agent, pi-tui, and pi-ai — packages pi itself ships, so there is nothing extra to install; startup-sync.ts auto-syncs the author's pi config repository but is strongly coupled to a local backup script and flagged as personal-environment-specific.
• $The README's own security note: extensions and skills run with your full permissions, so install only from trusted sources.

## FAQ

## References

• README ↗

Last updated: Sep 15, 2026