⚠️ 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

This repo is currently pinned to Pi 0.80.1 for local validation:

npm install
npm run typecheck
./node_modules/.bin/pi --version

1. Import SDK primitives from @howaboua/pi-howaboua-extensions-primitives-sdk in your Pi extension code.
2. Build your screens with the exported primitives.
3. 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)

Notes

• ./sdk/example is reference code and intended to stay stable.
• SDK changes should be intentional and minimal.
• Optional live preview: point repo-local Pi directly to ./sdk/example/index.ts: ./node_modules/.bin/pi -e ./sdk/example/index.ts.