@erikenz/pi-model-switch0.4.0

@erikenz/pi-model-switch

Fast model picker and favorite model cycling shortcuts for the Pi coding agent.

Inspired by @aiwayds/pi-model-favorites, rewritten with dedicated global shortcuts, direct hotkey cycling, and full vim navigation.

---

Features

• ⭐ Dual-Pane Model Picker: Your favorite models are pinned at the top separated by a divider, with all other available models cleanly grouped by provider below.
• 📊 Real-Time Quota Badges: Displays 5-hour and weekly limits (e.g. [5h: 86% (resets in 1h 28m) · W: 61%]), color-coded by severity (green/yellow/red). Works seamlessly with pi-antigravity-acp-provider and other providers.
• ⚡ Global Shortcut (Alt+M): Open the model picker modal from anywhere without typing a slash command.
• 🔁 Instant Cycling Shortcuts:
  • Ctrl+Alt+P: Cycle forward through your favorite models with an instant toast notification.
  • Ctrl+Alt+Shift+P: Cycle backward through your favorite models.
• ⌨️ Vim-Friendly Navigation:
  • j / ↓: Move down.
  • k / ↑: Move up.
  • g / Home: Jump to first model.
  • G / End: Jump to last model.
  • q / Esc: Close picker.
  • Enter: Select active model.
• 🧠 Thinking / Effort Selection (t / e):
  • For models that support reasoning, select your desired thinking/effort level (off, minimal, low, medium, high, xhigh) directly with vim navigation.
  • Displays token budgets / descriptions for each level.
  • Automatically saves your preferred thinking effort per model in model-switch.json and reapplies it when switching or cycling favorites.
• 🎯 In-Picker Management:
  • t or e: Open thinking / reasoning effort selector for the focused model.
  • d: Set focused model as Pi's global default model (persists to settings.json).
  • f: Toggle favorite on the focused model.
  • h: Toggle hide on the focused model.
  • b: Block focused model (permanently hides it from the picker and disables it across Pi).
  • v: Expand/collapse hidden models list.
  • /: Live fuzzy filter (type to search; Enter to apply, Esc to clear).
• 🛡️ Model Blocklist & Pi-Wide Enforcement:
  • Exclude models completely from the picker using exact provider/id or wildcard/glob patterns (ollama/*, *deprecated*, etc.).
  • Blocked models are omitted from favorite cycling (Ctrl+Alt+P / Ctrl+Alt+Shift+P).
  • Intercepts Pi's global model selection and startup events (model_select, session_start, before_agent_start) to prevent blocked models from being selected or used anywhere in Pi.
  • Manage blocked models directly with b in the picker or via /model-switch block <pattern>, /model-switch unblock <pattern>, and /model-switch blocked.
• 🔄 Automatic OpenCode Console Sync:
  • Automatically queries the OpenCode console API (https://opencode.ai/console/api/v2/config) using your configured API keys in auth.json.
  • Dynamically filters out all models disabled in your OpenCode console across opencode and opencode-go, so the picker only presents active, usable models.
  • Zero startup latency: loads instant cache from ~/.config/pi/agent/opencode-disabled-models.json and updates in the background.
  • Trigger manual re-sync at any time with r inside the picker or via /model-switch sync.
• 💾 Clean, Self-Contained Storage:
  • Saves favorite, hidden, blocked, and per-model thinking preferences directly to ~/.config/pi/agent/model-switch.json.

---

Installation

Via Pi Packages

Add to your ~/.config/pi/agent/settings.json:

{
  "packages": ["npm:@erikenz/pi-model-switch"]
}

Or install via Pi:

pi install @erikenz/pi-model-switch

Local / Development

Clone this repository into your extensions directory or symlink it:

git clone https://github.com/erikenz/pi-extensions.git ~/Projects/pi-extensions
ln -s ~/Projects/pi-extensions/packages/pi-model-switch/extensions/index.ts ~/.config/pi/agent/extensions/pi-model-switch.ts

---

Keybindings & Shortcuts

Shortcut / Key	Context	Action
Alt+M	Global	Open the favorite model picker modal
Alt+T	Global	Cycle thinking / effort level forward for current model
Alt+Shift+T	Global	Cycle thinking / effort level backward for current model
Ctrl+Alt+P	Global	Cycle forward to the next favorite model (applies saved thinking level)
Ctrl+Alt+Shift+P	Global	Cycle backward to the previous favorite model
/m or /model-switch	Slash command	Open picker modal (cycle [next|prev], thinking [next|prev], block <pattern>, unblock <pattern>, blocked also available)
j / ↓	Inside Picker	Move cursor down
k / ↑	Inside Picker	Move cursor up
g / Home	Inside Picker	Jump to top
G / End	Inside Picker	Jump to bottom
Enter	Inside Picker	Select focused model
t or e	Inside Picker	Open thinking / effort selector for reasoning-capable models
d	Inside Picker	Set focused model as Pi's default startup model
f	Inside Picker	Toggle favorite status
h	Inside Picker	Toggle hidden status
b	Inside Picker	Block focused model from picker and Pi
v	Inside Picker	Toggle show/hide hidden models
/	Inside Picker	Start filter / search
r	Inside Picker	Refresh live quotas and OpenCode console disabled models in background
q / Esc	Inside Picker	Cancel and close

---

Customizing Keybindings & Shortcuts

All global shortcuts and in-modal keys are fully configurable in ~/.config/pi/agent/model-switch.json.

You can remap any shortcut, bind multiple keys to the same action, or set a shortcut to null to disable it completely.

{
  "shortcuts": {
    "open": "alt+m",
    "cycleNext": "ctrl+alt+p",
    "cyclePrev": "ctrl+alt+shift+p",
    "thinkingNext": "alt+t",
    "thinkingPrev": "alt+shift+t"
  },
  "modalKeys": {
    "up": ["k", "up"],
    "down": ["j", "down"],
    "first": ["g", "home"],
    "last": ["G", "end"],
    "select": ["enter"],
    "cancel": ["q", "escape"],
    "thinking": ["t", "e"],
    "favorite": ["f"],
    "default": ["d"],
    "hide": ["h"],
    "block": ["b"],
    "toggleHidden": ["v"],
    "filter": ["/"]
  }
}

Configuration Examples

Block Models (Provider-Specific, Global, or Wildcards):

• Provider-specific: "opencode-go/gemini-4-argon" or "opencode*/gemini-4-argon" blocks Argon only from OpenCode while allowing it from other providers (e.g. Antigravity ACP).
• All providers: "gemini-4-argon" (without a slash) blocks the model across all providers.
• Provider-wide: "ollama/*" blocks all models from a given provider.
• Wildcard glob: "*deprecated*" or "*-preview".

{
  "blocked": [
    "opencode*/gemini-4-argon",
    "ollama/*",
    "gpt-6-luna",
    "*deprecated*"
  ]
}

Replace Pi's Default Model Picker (Ctrl+L):

{
  "shortcuts": {
    "open": "ctrl+l"
  }
}

Disable Direct Cycling Shortcuts:

{
  "shortcuts": {
    "cycleNext": null,
    "cyclePrev": null
  }
}

Colemak Navigation Inside Modal:

{
  "modalKeys": {
    "up": ["u", "up"],
    "down": ["e", "down"]
  }
}

Development & Testing

# Run unit tests
pnpm test

# Type check
pnpm typecheck

---

License

MIT © erikenz