pi-openai-fast

Pi extension for OpenAI Fast Mode.

Install

pi install git:github.com/studioarray/pi-openai-fast

Commands and CLI flags

• /fast toggles the desired Fast Mode state. With persistence enabled it writes desiredActive; with persistence disabled it is session-only. If the current model is unsupported or absent, the desired state stays true but Fast Mode remains inactive until an allow-listed model is selected.
• --fast starts one run with desired Fast Mode enabled and never writes config.

Default supported models

[
  "openai/gpt-5.4",
  "openai/gpt-5.5",
  "openai-codex/gpt-5.4",
  "openai-codex/gpt-5.5"
]

Fast Mode activates only when the current model matches one of these default entries. To change the list, edit supportedModels as shown in the config below.

Config

Extension config is read from ~/.pi/agent/extensions/pi-openai-fast.json and .pi/extensions/pi-openai-fast.json.

By default, /fast is session-only because persistState defaults to false. Set persistState to true in JSON to have /fast write desiredActive for future sessions.

Default config:

{
  "persistState": false,
  "desiredActive": false,
  "supportedModels": [
    "openai/gpt-5.4",
    "openai/gpt-5.5",
    "openai-codex/gpt-5.4",
    "openai-codex/gpt-5.5"
  ],
  "footer": {
    "mode": "replace",
    "vars": {},
    "darkFastColor": "#ff50be",
    "lightFastColor": "#d20000"
  }
}

supportedModels controls where Fast Mode is allowed to turn on:

• Each entry is a Pi model key in the form provider/model, for example openai/gpt-5.5.
• When Fast Mode is on and the current model matches, the extension asks for OpenAI's priority service tier.

footer.mode values:

• replace installs the Footer Clone and shows inline fast after the model name only while Fast Mode is active.
• status leaves Pi's footer in place and publishes only a fast status indicator while active.
• off leaves footer/status UI untouched.

Fast colors accept six-digit hex values, 256-color indexes, variable references from footer.vars, or an empty string for the terminal default foreground. Pi's built-in light theme uses lightFastColor; other themes use darkFastColor.

Reference attribution

Inspired by pi-better-openai.