@howaboua/pi-howaboua-extensions-primitives-sdk
v0.3.0
Published
WIP Pi extension primitives SDK for consistent TUI views
Maintainers
Readme
⚠️ WIP / personal-use package
This SDK is currently for use by howaboua to standardize personal Pi extensions. You can use it, but you do so at your own peril 😄
Pi Extensions Design SDK
A reusable SDK for building consistent, high-signal TUI views in Pi extensions.
What this gives you
- fixed-height panels with consistent headers/footers
- list/action/detail flows with shared interaction patterns
- attached detail previews above the main panel
- turnkey picker runtime for one-off selections (
runPicker) - turnkey multiline composer runtime for prompt/text editing (
runComposer) - wraparound navigation and predictable key behavior
Repo layout
./sdk→ framework-style SDK source./sdk/example→ frozen reference implementation
Quick start
- Import SDK primitives from
@howaboua/pi-howaboua-extensions-primitives-sdkin your Pi extension code. - Build your screens with the exported primitives.
- Register your command and call the shared runtime loop.
For API contracts and usage details, read:
./AGENT_REFERENCE.md(agent-first integration contract)./API_REFERENCE.md(fast export/signature map)./sdk/README.md(SDK internals and roles)
Migration helper
From this SDK repository checkout, rewrite local ./sdk style imports to the npm package automatically:
npm run migrate:sdk-imports -- /path/to/extensionNotes
./sdk/exampleis reference code and intended to stay stable.- SDK changes should be intentional and minimal.
- Optional live preview: point Pi directly to
./sdk/example/index.ts.
