HenryQW Pi packages

Public Pi packages under @henryqw scope.

Packages

Package	Purpose
@henryqw/pi-add-dir	Add external directories with context, skills, and file search.
@henryqw/pi-ask-question	Ask user one interactive multiple-choice or free-text question.
@henryqw/pi-auto-compact	Compact context at the set threshold and resume current task.
@henryqw/pi-deps	Prepare locked Node and uv dependencies for opted-in Git worktrees.
@henryqw/pi-herdr	Run Herdr CLI commands through a shared thin client.
@henryqw/pi-herdr-btw	Open and merge Pi side threads in Herdr panes.
@henryqw/pi-herdr-clone	Clone the current Pi conversation path into a new Herdr tab.
@henryqw/pi-herdr-done	Close and remove current Herdr worktree.
@henryqw/pi-herdr-rename	Generate short chat titles and rename current Herdr location.
@henryqw/pi-memory	Maintain size-capped agent memory and user-profile stores across sessions.
@henryqw/pi-multi-codex	Use multiple ChatGPT Codex OAuth accounts in Pi.
@henryqw/pi-notes	Keep persistent per-worktree notes visible in a Pi widget.
@henryqw/pi-open-in	Open current working directory with configurable command.
@henryqw/pi-footer	Henry's opinionated Pi footer style for concise checkout and usage details.
@henryqw/pi-pr	Show current-branch PR lifecycle, CI, mergeability, and review state in Pi footer.
@henryqw/pi-session-recall	Search past Pi sessions with local FTS5 and zero LLM calls.
@henryqw/pi-subagent	Delegate one task to an isolated role with explicit extensions and skills.
@henryqw/pi-task-models	Shared fast/balanced/frontier model profiles for HenryQW extensions.

Deprecated

Retired extensions and their replacements are recorded under deprecated/.

Remove

pi remove npm:@henryqw/<package>

Replace <package> with the package's unscoped name, for example pi-subagent.

Before removing @henryqw/pi-deps, disable each opted-in repository with /deps: its copied hook is self-contained.

After removing @henryqw/pi-session-recall, delete its derived index to reclaim storage:

rm -rf ~/.pi/agent/config/pi-session-recall/

Development

Requires Node.js >=22.19.0.

npm ci
npm test
npm run typecheck
npm run pack:check

Run live Pi integration tests only when authenticated model access is available:

npm run test:live

Live tests use real model requests and can incur provider cost. They set a temporary small context window so compaction completes quickly.

Manual Pi TUI check for @henryqw/pi-ask-question:

npm run test:manual --workspace @henryqw/pi-ask-question

@henryqw/pi-auto-compact live test needs real Pi and authenticated model access:

npm run test:live --workspace @henryqw/pi-auto-compact
PI_AUTO_COMPACT_AUTH_FILE=/path/to/auth.json npm run test:live --workspace @henryqw/pi-auto-compact

Set PI_AUTO_COMPACT_AUTH_FILE only when auth is not at ~/.pi/agent/auth.json.

Release

See docs/releasing.md. Each package publishes independently; package names use @henryqw scope.