Skip to content

README.md

Latest commit

 

History

History
86 lines (61 loc) · 3.68 KB

README.md

File metadata and controls

86 lines (61 loc) · 3.68 KB
Raw

HenryQW Pi packages

Public Pi packages under @henryqw scope.

Pi packages in use

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.