Pi Model Modes

Mode presets for switching models and thinking levels in Pi.

Install

pi install npm:@zigai/pi-model-modes

Features

• Adds /mode for selecting and configuring prompt modes.
• Adds Ctrl+Shift+M to select a mode.
• Supports optional forward and backward keyboard shortcuts for cycling modes.
• Colors the prompt editor border from the active mode, with an opt-in setting for thinking-derived border colors.
• Applies an optional persistent default model to fresh sessions without changing it when the session model changes.

Modes can store a provider, model, thinking level, and optional color. Their JSON object order is the exact cycle order; with configured modes, no implicit entries are added. Mode cycling matches the active provider and model, ignoring thinking level, and wraps from the last mode to the first and vice versa. No cycling shortcut is configured by default.

Set the persistent default through /mode → Configure modes… → Set default model…, or edit defaultModel in the configuration file.

Configuration

Global settings are stored in ~/.pi/agent/extension-settings/pi-model-modes.json.

Option	Type	Default	Description
version	number	1	Settings format version.
currentMode	string	"default"	Currently selected mode ID.
defaultModel.provider	string	—	Default model provider.
defaultModel.modelId	string	—	Default model ID.
defaultModel.thinkingLevel	unknown	—	Optional default thinking level.
modeUseThinkingBorderColors	boolean	false	Use thinking-level colors instead of mode colors for borders.
modeShowThinkingLevelStatus	boolean	false	Show thinking level alongside mode status.
shortcuts.forward	string	—	Shortcut for cycling modes forward.
shortcuts.backward	string	—	Shortcut for cycling modes backward.
modes	object	{}	Named model-mode specifications keyed by mode ID.

{
  "$schema": "./schemas/pi-model-modes.schema.json",
  "version": 1,
  "currentMode": "default",
  "modeUseThinkingBorderColors": false,
  "modeShowThinkingLevelStatus": false,
  "modes": {}
}

License

MIT