masks # masks Switch model and thinking level together with named presets and shortcuts. Masks never changes tools or prompt instructions. ![masks demo: alt+2 switches to deep thinking, /masks fast switches back](assets/demo.gif) ## Use Configure presets in your Pi user settings, then press `alt+m` or run `/masks` to choose one. Run `/masks ` or use a preset's shortcut to switch directly. ```json { "masks": { "items": [ { "name": "deep", "model": "provider/model-from-pi", "thinkingLevel": "high", "shortcut": "alt+2" } ] } } ``` Replace `provider/model-from-pi` with an available provider-qualified model ID. Each preset needs a unique name, model, and thinking level. Shortcuts are optional; `masks.pickerShortcut` changes the default `alt+m`. Selections stay active until you switch again. Masks reads user settings only, not project settings. Old `tools` and `instructions` fields are ignored; prompt-template `mask` frontmatter no longer selects a preset. After changing settings, reload Pi. [Installation](../../README.md#install) ## Reference ### Commands | Command | Purpose | | --- | --- | | `/masks` | Switch model and thinking mask | ### Setting names | Setting | | --- | | `masks` | #### Object fields Paths below describe fields inside their parent settings object, not literal top-level keys. `[]` denotes an array element; see setup above for examples and defaults. | Field | | --- | | `masks.pickerShortcut` | | `masks.items` | | `masks.items[].name` | | `masks.items[].model` | | `masks.items[].thinkingLevel` | | `masks.items[].shortcut` |