# 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 ` 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` |