npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@yceachan/pi-codex-imagegen

v0.1.0

Published

pi extension: background Codex imagegen with fixed staging-file delivery through a separately loaded pi-shelld

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

yceachanyceachan

Keywords

pi-packagepi-extensionpicodeximagegenimage-generationbackground-process

Readme

pi-codex-imagegen

A pi extension that delegates PNG generation to the locally authenticated Codex CLI and its built-in imagegen capability.

Codex runs in an isolated temporary directory through a separately loaded @yceachan/pi-shelld extension. The ⭕shell monitor shows its live status, runtime, and log while the main agent keeps working. The two packages are installed and loaded independently; pi-codex-imagegen does not depend on or bundle pi-shelld.

Install

Install both pi packages separately:

pi install npm:@yceachan/pi-shelld
pi install npm:@yceachan/pi-codex-imagegen

Local packages work the same way as long as both extensions are loaded into the same pi process. Install Codex CLI and complete codex login first. The extension reuses that local login and does not accept or store API keys.

Tool

The extension registers pi-codex-imagegen:

{
  "imagePrompt": "A system architecture overview showing the complete request lifecycle",
  "outputPath": "output/imagegen/architecture.png"
}
  • imagePrompt passes the user's image intent, content, and style to Codex without requiring pi to rewrite it into a detailed generation recipe. Size belongs here only when relevant.
  • outputPath is a required, non-existing .png destination, absolute or relative to pi's current working directory.
  • Parent directories are created automatically; existing files are never overwritten.

The tool returns the pi-shelld shell ID immediately. Codex receives a short task in an isolated temporary directory and owns the complete image-generation workflow, including placing the final PNG at the fixed staging path result.png.

After Codex exits successfully, the extension copies result.png exclusively to outputPath, removes the staging file, closes the shell record/log, removes the temporary working directory, and posts completion to chat. There is no resize layer, generated-images scan, final-response path protocol, or retained source copy.

If pi-shelld service v1 is not loaded, the tool fails before creating a temporary directory or starting Codex and explains how to install or load pi-shelld.

License

MIT