pi-better-openai

Personal pi extension that improves OpenAI with fast mode, usage stats, and footer polish.

Package details

← Back
extension

Install pi-better-openai from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-better-openai
Package
pi-better-openai
Version
0.1.13
Published
May 5, 2026
Downloads
1,178/mo · 1,178/wk
Author
mrchu001
License
MIT
Types
extension
Size
138.1 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-better-openai

A pi extension for OpenAI subscription workflows: fast mode, usage visibility, footer polish, and image generation through openai-codex auth.

Install

Install from GitHub:

pi install git:github.com/mattleong/pi-better-openai

Or install from npm:

pi install npm:pi-better-openai

Features

  • Fast mode for supported OpenAI models, toggled with /fast or in /openai-settings.
  • OpenAI subscription usage display via /openai-usage and the footer.
  • Interactive settings picker via /openai-settings.
  • Footer customization for model, thinking, fast mode, usage, and token/cost context.
  • OpenAI image generation/editing through the openai_image tool and /openai-image command.
  • Animated Codex custom pets rendered in the Better OpenAI footer.
  • Commands:
    • /fast toggles fast mode.
    • /openai-image <prompt> generates an image directly.
    • /pets [help|list|wake [slug]|tuck|select <slug>] renders or manages custom pets from ${CODEX_HOME:-~/.codex}/pets.
    • /openai-usage shows current OpenAI subscription usage.
    • /openai-settings opens settings, diagnostics, and config details.

Codex pets

Codex pets are an OpenAI Codex app feature, so the floating overlay and pet picker are still controlled by Codex (Settings → Appearance → Pets or /pet). This extension can also render compatible custom pet spritesheets directly in pi's Better OpenAI footer.

/pets wake          # render the selected pet, or pick one if none is selected
/pets wake <slug>   # render a specific ready pet
/pets select <slug> # select a ready pet without changing visibility
/pets tuck          # hide it
/pets list          # list local custom pets and readiness diagnostics

You can also enable Footer pet in /openai-settings, cycle installed pets with the Pet row, preview the selected pet in the footer, and tune placement (inline-right by default), idle, thinking/streaming, tool-execution, and any failed-tool animation states, plus random idle emotes and size.

To create a custom pet for the Codex app:

$skill-installer hatch-pet

Then reload Codex skills (Cmd/Ctrl+K → Force Reload Skills) and ask:

$hatch-pet create a new pet inspired by pi-better-openai

Custom pets should end up in ${CODEX_HOME:-~/.codex}/pets/<pet-name>/ with pet.json and spritesheet.webp. Refresh custom pets in Codex settings and toggle the overlay with /pet.

Screenshots