my-pi/pi-extension-codex-fast-mode/README.md

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:

<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 for provenance, TECHNICAL.md for runtime behavior, and DEVELOPMENT.md for validation. The upstream MIT license is retained in LICENSE.