Codex Image Gallery Skill

Codex Image Gallery

Start a local browser gallery for Codex image outputs. This skill is self-contained: the server lives in scripts/server.mjs, and the UI template lives in assets/index.html.

Quick Start

Run commands from this skill directory, the directory containing this SKILL.md.

node scripts/server.mjs

The server prints the actual URL. It starts at http://127.0.0.1:8765/ and tries later ports if the default is occupied.

Workflow

Check the default URL first:

node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length)).catch(() => process.exit(1))'

If this succeeds, reuse the running server at http://127.0.0.1:8765/.

If the API check fails, check for a running server process:
```
pgrep -fl 'node .*server\.mjs' || true
```
When a process exists but the default URL fails, inspect its stdout or try likely later ports because the server auto-increments when a port is occupied.

Verify any reused URL before reporting success:

node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length))'

If the server chose another port, use that port.

Start the server if none is running:
```
node scripts/server.mjs
```
Keep the process running for the user and read stdout for the URL.
Open the browser unless the user asks for URL-only:
```
open http://127.0.0.1:8765/
```

Image Root

Default image root:

~/.codex/generated_images

Use a different folder with:

GALLERY_ROOT=/path/to/images node scripts/server.mjs

Validation

Before declaring the skill healthy after edits, run:

node --check scripts/server.mjs

Then start the server and verify:

GET /api/images returns JSON with rootPath and items
/images/<relative-path> returns image content for at least one listed item
The page loads from the bundled assets/index.html

Response

Report the URL, image root, whether the server was reused or newly started, and any verification failure. Keep the answer short.

Agent Skills: Codex Image Gallery

Install this agent skill to your local

Skill Files