pi-startup-picker

Pi extension that lets power users choose provider and model at startup before the session begins.

Packages

Package details

extensionskillthemeprompt

Install pi-startup-picker from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-startup-picker
Package
pi-startup-picker
Version
0.1.0
Published
Jun 11, 2026
Downloads
not available
Author
eiei114
License
MIT
Types
extension, skill, theme, prompt
Size
33.7 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Startup Picker

CI Publish npm version npm downloads License: MIT Pi package Trusted Publishing

Choose your provider and model at Pi startup, before the session begins.

What this is

Pi Startup Picker is a Pi extension for power users who switch models often and want that choice up front instead of launching Pi and then detouring to /model.

Current state: the first vertical slice is implemented. On normal startup, the extension can show a provider/model picker, remember recent combinations, and fall back to the existing default model when canceled.

Current features

  • Show a provider and model picker on session_start for normal startup.
  • Surface recent provider/model combinations so repeated launches are faster.
  • Fall back to the user's existing default provider/model when the picker is canceled or selection fails.
  • Persist recent combinations in a small global JSON file across launches.

Install

Published package:

pi install npm:pi-startup-picker

From GitHub:

pi install git:github.com/eiei114/pi-startup-picker

Try locally during development:

pi -e .

Quick start

Useful smoke commands:

/startup-picker:about
/startup-picker:hello

The main behavior is automatic on normal Pi startup.

Package contents

Path Purpose
extensions/ Pi extension entrypoints and early smoke commands
lib/ Shared TypeScript helpers
skills/ Agent Skills
prompts/ Prompt templates
themes/ Theme placeholders from the template
docs/ Supporting docs and bootstrap notes

Development

npm install
npm run ci

Release

This package is set up for npm Trusted Publishing, so no NPM_TOKEN is required.

npm version patch
git push

See docs/release.md for setup details.

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

For vulnerability reporting, see SECURITY.md.

Links

License

MIT