Pi Extension Settings

Persistent, typed settings for Pi extensions. Define one TypeBox schema and reuse it for runtime types, validation, defaults, editor schemas, and user documentation.

Install

Using Pi Extension Template is the recommended way to create a new extension. It generates the settings structure, commands, and runtime loader for you.

To add settings to an existing extension:

npm install @zigai/pi-extension-settings

Then follow Add settings to an existing Pi extension.

Features

• Typed defaults and decoded runtime values from one TypeBox schema
• Global settings with optional trusted-project overrides
• Generated config.schema.json and README configuration documentation
• A checked-in prevalidation artifact for the Pi runtime path
• Safe diagnostics that do not expose setting values
• Locked, validated, atomic settings updates when an extension needs to write configuration

Documentation

• Add settings to an existing Pi extension
• Generated artifacts and command behavior
• Runtime loading and transactional updates
• Optional settings-editor controls
• Generate a complete extension with Pi Extension Template

License

MIT