Luigit
repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by admin

extensions/masks/README.md

Raw
Rendered preview
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

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.

{
  "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

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
<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.

![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 <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 -->