@lwlee2608/pi-model-plus0.1.2
Bookmark favorite Pi models and switch between them with /model-plus.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-model-plus
Bookmark favorite models in Pi and switch between them without searching the full model list.
Install
pi install npm:@lwlee2608/pi-model-plus
Run /reload in an existing Pi session after installation.
Previously published as pi-model-plus. To migrate, run pi remove npm:pi-model-plus and install the scoped package; saved bookmarks are kept.
Requires Node.js 22.19 or newer. Developed and checked against @earendil-works/pi-coding-agent 1.0.0.
Use
Run /model-plus. This is the extension's only command.
| Key in the favorites menu | Action |
|---|---|
| Type | Filter saved models. |
| Up / Down | Move the selection. |
| Page Up / Page Down | Move by 10 filtered entries, stopping at either end. |
| Enter | Switch to the selected model without changing the default. |
| Ctrl+S | Switch to the selected model and save it as the default for new sessions. |
| Ctrl+N | Open the full model browser to add favorites. |
| Ctrl+R | Remove the selected bookmark, including unavailable models. |
| Escape | Close the menu. |
In the model browser, type to search by provider, model ID, or name. Press Enter to toggle a bookmark (★). You can mark several models without closing the browser. Escape returns to the refreshed favorites menu. Changes save immediately and do not switch the active model.
Enter, arrow keys, Page Up/Down, and Escape follow Pi's selection keybindings. Ctrl+S follows Pi's app.models.save keybinding, shared with /model. To change the shortcuts, add overrides to ~/.pi/agent/keybindings.json:
{
"pi-model-plus.add": "ctrl+n",
"pi-model-plus.remove": "ctrl+r",
"app.models.save": "ctrl+s"
}
The add/remove shortcuts only apply inside the favorites menu.
The picker marks the current model, the saved global default, and unavailable models. Search for default to find the bookmarked default. Unavailable bookmarks stay saved until you remove them and cannot be selected or saved as default.
Enter switches through Pi's API without changing defaults. Ctrl+S switches first, then saves defaultProvider and defaultModel in Pi's agent-directory settings.json, preserving unrelated settings. Failed switches do not change defaults; failed saves are reported separately. Project settings and startup CLI options can override this global default. Pi's built-in /model may need /reload to refresh its cached default badge after this extension saves it.
This extension does not modify or replace /model, /scoped-models, or Ctrl+P cycling. It does not register global keyboard shortcuts.
Storage
Bookmarks are saved across projects and sessions at:
~/.pi/agent/pi-model-plus/favorites.json
Pi's PI_CODING_AGENT_DIR override is respected. Only provider and model IDs are stored, not credentials or conversation data. Separate Pi processes lock updates to avoid losing bookmarks. File replacement is atomic; malformed files are reported rather than overwritten.
Adding/removing bookmarks and setting the default require interactive terminal mode. RPC clients with selection dialogs can use /model-plus to switch between existing favorites, but do not get the menu shortcuts. The model browser lists the current model catalog for configured providers; open /model first if you need Pi to refresh that catalog.
Local development
From the repository root:
npm ci --ignore-scripts
npm run check
npm test
pi -e ./packages/model-plus/src/index.ts
No build step is required. Pi loads the TypeScript source. See the repository README for releases.
License
MIT