# GPT-5.6 Switcher for Pi

[English](README.md) | [简体中文](README.zh-CN.md)

[![CI](https://github.com/yoyooyooo/gpt56-switcher/actions/workflows/ci.yml/badge.svg)](https://github.com/yoyooyooo/gpt56-switcher/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

A keyboard-first [Pi](https://github.com/earendil-works/pi) extension for switching GPT-5.6 capability models and thinking levels without leaving the current Provider.

![GPT-5.6 Switcher preview](docs/assets/preview.png)

> The screenshot shows one Provider configuration. The extension derives the visible rows and thinking levels from your live Pi model registry.

## Why

A Provider may expose GPT-5.6 as several capability models—Luna, Terra, and Sol—with different supported thinking levels. Pi can switch models and thinking independently, but repeatedly opening separate selectors makes this combination slower to inspect and change.

GPT-5.6 Switcher turns the valid combinations into one inline, three-row selector:

- discovery is restricted to the active Provider;
- unavailable capability models are omitted;
- unsupported thinking levels are omitted from each row;
- navigation previews only; Enter applies the model and thinking level together;
- the footer compares the current and target Profiles, highlighting changed target fields in yellow; an active non-GPT-5.6 model is shown as `Other` rather than being misidentified as a capability tier.

## Requirements

- `@earendil-works/pi-coding-agent` 0.80.10 or later
- A Provider that registers at least one of:
  - `gpt-5.6-luna`
  - `gpt-5.6-terra`
  - `gpt-5.6-sol`

The extension does not register models or Providers. It only uses models already present in Pi's model registry.

## Installation

Install from npm:

```bash
pi install npm:pi-gpt56-switcher
```

Or install directly from GitHub:

```bash
pi install git:github.com/yoyooyooo/gpt56-switcher
```

Restart Pi or run `/reload` in an existing TUI session.

For local development:

```bash
git clone https://github.com/yoyooyooo/gpt56-switcher.git
cd gpt56-switcher
bun install
pi -e .
```

## Usage

Open the selector:

```text
/g56
```

Apply a Profile directly without opening the selector:

```text
/g56 terra high
/g56 sol max
```

If the requested model or thinking level is unavailable in the active Provider, the command makes no change and reports the unavailable Profile.

### Controls

| Key | Action |
|---|---|
| Left / Right | Move between supported thinking levels in the current row |
| Up / Down | Move between available capability rows while preserving or safely clamping thinking |
| Home / End | Jump to the first or last thinking level in the current row |
| `1` / `2` / `3` | Jump to Luna / Terra / Sol when available |
| Enter | Apply the target model, then its thinking level |
| Escape | Cancel without changing anything |

## Discovery rules

Capability order is fixed as Luna → Terra → Sol. Thinking order follows Pi:

```text
off → minimal → low → medium → high → xhigh → max
```

For every matching model, the extension follows Pi's model metadata semantics:

- `reasoning: false` exposes only `off`;
- a `thinkingLevelMap` value of `null` marks that level unsupported;
- `xhigh` and `max` are shown only when explicitly mapped;
- ordinary levels use Pi defaults when their map entry is absent.

No fallback to another Provider occurs.

## Interaction design

Pi custom components expose keyboard input but no public mouse coordinates, hit testing, or drag events. The extension therefore uses a three-row keyboard interface instead of taking ownership of terminal mouse tracking or starting a second renderer.

The selector is transactional from the user's perspective:

1. movement updates only the preview;
2. Escape exits with no state change;
3. Enter calls Pi's model switch first;
4. after a successful model switch, it applies the selected thinking level;
5. Pi's effective thinking level is reported, including any unexpected clamp.

## Privacy and security

The extension reads only in-process model metadata exposed by Pi. It does not read Provider credential files, send telemetry, or make model requests. Authentication, routing, and credential storage remain owned by Pi and the active Provider.

See [SECURITY.md](SECURITY.md) for reporting guidance.

## Development

```bash
bun install
bun test
bun run typecheck
```

Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

[MIT](LICENSE)