# Prompt Thinking extension

Type `^level` to set the thinking level for one prompt. Use the keyboard shortcuts to cycle or select the session thinking level. The control token is removed before the prompt is sent.

## Install

```bash
pi install npm:@siddr/pi-prompt-thinking
```

## Usage

1. Type `^` anywhere in the prompt where whitespace-delimited tokens are allowed.
2. The thinking-level autocomplete opens automatically. On pi versions without natural autocomplete triggers, press **Tab** after `^`.
3. Pick a level from autocomplete.
4. Send the prompt normally.
5. pi temporarily applies that thinking level for the prompt, then restores the previous session level after the response finishes.

### Keyboard shortcuts

- **Alt+Shift+Tab** cycles backward through the thinking levels available for the active model. It wraps from the lowest available level to the highest and skips unsupported levels.
- **Ctrl+Shift+T** opens a filterable list of available thinking levels with the current level selected, then sets the chosen session level.

### Examples

Typing:

```text
^high summarize the tradeoffs
```

submits as:

```text
summarize the tradeoffs
```

Typing:

```text
Please ^minimal answer briefly
```

submits as:

```text
Please answer briefly
```

## Autocomplete behavior

- Typing `^` opens the thinking-level picker automatically in pi versions that support natural autocomplete triggers. Press **Tab** if your pi version requires manual autocomplete or if you need to reopen it.
- The current thinking level is read when the picker opens and preselected when it is available for the active model.
- Up/down arrows move through lower/higher thinking levels because suggestions stay in natural order.
- Available levels depend on the current model:
  - non-reasoning models: `^off`
  - reasoning models: `^off`, `^minimal`, `^low`, `^medium`, `^high`
  - xhigh-capable models: also `^xhigh`
  - max-capable models: also `^max`

## Token rules

- `^level` can appear anywhere in the prompt as a standalone whitespace-delimited token.
- Matching is case-insensitive (`^HIGH` works).
- Unknown tokens are left unchanged.
- If multiple recognized tokens appear, the first recognized level wins and all recognized `^level` tokens are removed before submission.

## Notes

- The one-prompt behavior is implemented by temporarily changing pi's session thinking level before the prompt runs and restoring the previous level afterward.
- Because pi does not currently expose a true per-turn thinking override API to extensions, this may still append thinking-level-change entries to the session history and briefly update the default thinking setting before it is restored.
- Submit-time stripping works even when custom editor UI is unavailable; autocomplete itself is interactive-TUI only.