pi-model-picker

Categorized, keyboard-driven model selector for the pi coding agent

Package details

← Back

extension

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

npm repo home report

$ pi install npm:pi-model-picker

Package: pi-model-picker
Version: 1.0.0
Published: Feb 25, 2026
Downloads: 21/mo · 9/wk
Author: rilham97
License: MIT
Types: extension
Size: 24.3 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-model-picker

A categorized, keyboard-driven model selector extension for the pi coding agent.

Instead of a flat searchable list, models are grouped by provider in horizontal tabs. Switch categories with Tab or arrow keys, type to filter within a category, and navigate with ↑/↓.

Preview

╔═════════════════════════════════════════════════════════════════╗
║  Select Model                                                   ║
╠═════════════════════════════════════════════════════════════════╣
║◀  Anthropic │ Google │ Cliproxyapi │ Ollama ▶                   ║
║─────────────────────────────────────────────────────────────────║
║  Search: claude_                                                ║
║─────────────────────────────────────────────────────────────────║
║▶ Claude Sonnet 4.6 ●                         200k  thinking     ║
║  Claude Opus 4.5                             200k  thinking     ║
║  Claude Haiku 3.5                            200k  vision       ║
║─────────────────────────────────────────────────────────────────║
║  ↑↓ navigate  ·  Tab/← → category  ·  enter select  ·  esc     ║
╚═════════════════════════════════════════════════════════════════╝

Active model shown with ● and highlighted in green
Context window shown as 200k, 1M, etc.
Capability tags: thinking (extended reasoning), vision (image input)
Search filters by model name or id within the current category
Search term preserved per category — switch away and back, your query is still there
Wraparound navigation — ↑ on the first item jumps to the last, and vice versa

Install

Via npm (recommended)

npm install -g pi-model-picker
pi-model-picker

Restart pi after installation.

Via pi package manager

pi install npm:pi-model-picker

Via git

pi install git:github.com/rilham97/pi-model-picker

Manual

git clone https://github.com/rilham97/pi-model-picker.git \
  ~/.pi/agent/extensions/model-picker

Restart pi.

Usage

Trigger	Description
`/models`	Open the categorized picker
`Ctrl+Shift+M`	Keyboard shortcut

Note: /model is a built-in pi command and cannot be overridden. Use /models (with an s) for this picker. The built-in /model (flat search) continues to work as normal.

Controls

Key	Action
`↑` / `↓`	Navigate models (wraps around)
`Tab` / `Shift+Tab`	Switch provider category
`←` / `→`	Switch category (when search field is empty)
`←` / `→`	Move cursor in search field (when field has text)
Type	Filter models in the current category
`Enter`	Select highlighted model
`Esc`	Cancel

How it works

The picker calls modelRegistry.refresh() then modelRegistry.getAvailable() — the same data source as pi's built-in /model command. Only models with auth configured (API key or OAuth) are shown. Models are grouped by their provider field and sorted alphabetically within each category, with the currently active model's provider appearing first.

Uninstall

pi remove npm:pi-model-picker
rm -rf ~/.pi/agent/extensions/model-picker

License

MIT