# Codex Fast Mode for Pi

A locally maintained fork of `@firstpick/pi-extension-codex-fast-mode@0.1.1` that adds a cross-session Fast mode default.

## Behavior

- `/fast-mode on` and `/fast-mode off` update the current session and the global default for future sessions.
- A new session inherits the global default.
- A resumed session branch keeps its own latest recorded setting, overriding the global default.
- Only `openai-codex` requests using `openai-codex-responses` receive `service_tier: "priority"`.
- Other providers, APIs, payload fields, and authentication remain unchanged.

The global preference is stored at:

```text
<Pi agent dir>/extensions/pi-extension-codex-fast-mode/config.json
```

Normally this is `~/.pi/agent/extensions/pi-extension-codex-fast-mode/config.json`. The directory and file are restricted to owner-only permissions (`0700` and `0600`). Missing, unreadable, or invalid configuration fails safely to Fast mode off.

## Commands

- `/fast-mode` toggles Fast mode and saves the new global default.
- `/fast-mode on` enables it and makes new sessions default to on.
- `/fast-mode off` disables it and makes new sessions default to off.
- `/fast-mode status` reports the active branch setting and the default for new sessions.

Mode changes are rejected while Pi is busy; status remains available.

## Installation in my-pi

The root bundle loads this directory directly and declares it as a local `file:` dependency. Do not also install the upstream npm package, or Pi may load the command twice.

## Source and technical details

See [UPSTREAM.md](UPSTREAM.md) for provenance, [TECHNICAL.md](TECHNICAL.md) for runtime behavior, and [DEVELOPMENT.md](DEVELOPMENT.md) for validation. The upstream MIT license is retained in [LICENSE](LICENSE).
