feat: vendor and persist Codex fast mode

This commit is contained in:
叶林立
2026-08-20 00:06:39 +08:00
parent bd7ff978e9
commit d3bf562189
13 changed files with 804 additions and 20 deletions
+36
View File
@@ -0,0 +1,36 @@
# 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).