@capyup/pi-codex-image

Pi package that exposes Codex-style image_generation and view_image tools with dynamic model routing.

Packages

Package details

extensionskill

Install @capyup/pi-codex-image from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@capyup/pi-codex-image
Package
@capyup/pi-codex-image
Version
0.2.2
Published
May 12, 2026
Downloads
not available
Author
capyup
License
MIT
Types
extension, skill
Size
21.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/codex-image.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

pi-codex-image

Contributes the image portion of IgorWarzocha/pi-codex-conversion as a focused Pi package. Current release version: 0.2.2.

This package ports the Codex-style image_generation and view_image capabilities without replacing Pi's full tool surface.

It provides:

  • Extension tool: image_generation
  • Extension tool: view_image
  • Skill: image-generation

Behavior

pi-codex-image dynamically routes tools based on the currently selected model:

  • image_generation is active only when the current provider is openai-codex and the selected model advertises image input support.
  • view_image is active for any selected model that advertises image input support.
  • Switching models triggers the router again, adding these tools when supported and removing them when unsupported.
  • Existing non-image active tools are preserved while image tools are added or removed.

Native image generation

The image_generation tool mirrors pi-codex-conversion's native-tool approach:

  1. The agent sees a function-style tool named image_generation.
  2. Before the provider request is sent, the extension rewrites that function tool into the OpenAI Codex Responses native tool:
{ "type": "image_generation", "output_format": "png" }
  1. The local function body is intentionally not used; if it executes locally, it throws an explanatory error.

Generated image handling is therefore delegated to the active OpenAI Codex Responses provider, matching the referenced adapter's routing semantics.

View images

view_image wraps Pi's native image reader and returns only image content to the model.

Parameters:

{
  "path": "./local-image.png",
  "detail": "original"
}
  • path is required and may be absolute or relative to the current working directory.
  • detail: "original" is exposed only for Codex-family image-capable models.
  • file_path and image_path are accepted as compatibility aliases and normalized to path.

Install

From a checkout:

pi install npm:@capyup/pi-codex-image

For one session:

pi -e /path/to/pi-codex-image

Run /reload after installing into an active session.

Development

Package metadata:

  • Package name: @capyup/pi-codex-image
  • Version: 0.2.2
  • Repository: https://github.com/capyup/pi-codex-image
  • Extension entry: extensions/codex-image.ts
  • Skill directory: skills/image-generation

When syncing with upstream, compare against pi-codex-conversion's image-generation-tool.ts, view-image-tool.ts, and dynamic tool routing in index.ts.