2.3 KiB
Technical reference: Codex Fast Mode for Pi
Advanced behavior, configuration, compatibility, and troubleshooting for the locally maintained fork.
Back to README · Development guide · Upstream provenance
Commands
/fast-mode— toggle the active branch and global default./fast-mode on— enable the active branch and make future sessions default to on./fast-mode off— disable the active branch and make future sessions default to off./fast-mode status— show both the active branch setting and global default.
Mutation is refused while Pi is busy. Status remains available.
Persistence
The extension stores the global default in:
<Pi agent dir>/extensions/pi-extension-codex-fast-mode/config.json
The file contains a single boolean setting:
{
"enabled": true
}
Writes use a temporary file followed by atomic rename. The extension enforces 0700 on the containing directory and 0600 on the file. Missing configuration defaults to off. Malformed or unreadable configuration also fails to off and emits a warning without overwriting the bad file automatically.
Pi custom session entries remain branch-scoped. On session start or tree navigation, the latest valid branch entry overrides the global default. Consequently, resumed historical branches retain their own decision while genuinely new sessions inherit the latest global setting.
Eligibility and credit use
Fast mode applies only when the selected model has provider openai-codex and API openai-codex-responses. For eligible plain-object payloads, the extension returns a shallow copy with service_tier: "priority"; unsupported providers, APIs, disabled state, and malformed payloads pass through unchanged.
Fast mode expresses request intent and cannot guarantee that the upstream service accepts or provides priority processing. OpenAI controls account and model eligibility, credit multipliers, and current service terms.
Privacy and limitations
The extension does not inspect credentials, change authentication, choose a model, or make a separate network request. The only additional local data is the boolean global preference. If multiple Pi processes change the setting concurrently, the last successful atomic write becomes the default for future sessions.