Switch model and thinking level together with named presets and shortcuts.
Masks never changes tools or prompt instructions.
Use
Configure presets in your Pi user settings, then press alt+m or run /masks to choose one.
Run /masks <name> or use a preset's shortcut to switch directly.
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.
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
<img src="assets/banner.svg" alt="masks" height="70">
# masks
Switch model and thinking level together with named presets and shortcuts.
Masks never changes tools or prompt instructions.

## Use
Configure presets in your Pi user settings, then press `alt+m` or run `/masks` to choose one.
Run `/masks <name>` 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
<!-- config:start -->
### 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` |
<!-- config:end -->