@howaboua/pi-codex-imagegen
Codex image generation and editing for Pi, Code Mode and Notebook Mode.
Package details
Install @howaboua/pi-codex-imagegen from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@howaboua/pi-codex-imagegen- Package
@howaboua/pi-codex-imagegen- Version
0.0.5- Published
- Sep 14, 2026
- Downloads
- 648/mo · 578/wk
- Author
- howaboua
- License
- MIT
- Types
- extension
- Size
- 118.4 KB
- Dependencies
- 2 dependencies · 3 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-codex-imagegen
Codex image generation and editing for ordinary Pi, Code Mode, and Notebook Mode.
Install
pi install npm:@howaboua/pi-codex-imagegen
Requires Pi 0.84.4 or newer and Node.js 22.19 or newer.
Run /login openai-codex for the normal Codex route, including when chatting with another provider. Compatible active Codex transports keep their own credentials. Pi Codex's resolver is preferred when present, but its conversation-provider scope does not select tool endpoints. Neither Pi Codex nor an install script is required.
Pi Codex 3.0.25 or newer is optional. With it installed, the normal imagegen tool becomes tools.image_gen__imagegen inside Code and Notebook Mode.
Use
Provide only a prompt to generate. For edits, provide up to five PNG, JPEG, GIF, or WebP paths, or select the smallest recent conversation-image count that covers the targets.
Images are saved beneath the workspace at .pi/openai-codex-images with a latest.png alias.
For a proxy that renames Codex providers or models, create pi-codex-tools.json in Pi's agent directory:
{
"providers": {
"company-codex": {
"gpt-image-2.5": "company-image"
}
}
}
Each provider key identifies a Codex endpoint route. Its object maps the tool's canonical model names to that provider's aliases. Use an empty object when the provider renames no models.