codex-image-gallery
/codex-image-gallery
Start or reuse a self-contained local web gallery for browsing Codex-generated images. Use when the user asks to browse Codex generated images, open a local image gallery, inspect ~/.codex/generated_images, view a Codex image output folder, or browse image files produced by Codex.
- Author
- daymade ↗
- Repository
- claude-code-skills ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 5
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/server.mjs
What it does and when to use it
Start or reuse a self-contained local web gallery for browsing Codex-generated images. Use when the user asks to browse Codex generated images, open a local image gallery, inspect ~/.codex/generated_images, view a Codex image output folder, or browse image files produced by Codex.
Original author description
Start or reuse a self-contained local web gallery for browsing Codex-generated images. Use when the user asks to browse Codex generated images, open a local image gallery, inspect ~/.codex/generated_images, view a Codex image output folder, or browse image files produced by Codex.
How it works
- Quick Start
- Workflow
- Image Root
- Validation
- Response
SKILL.md preview
---
name: codex-image-gallery
description: Start or reuse a self-contained local web gallery for browsing Codex-generated images. Use when the user asks to browse Codex generated images, open a local image gallery, inspect ~/.codex/generated_images, view a Codex image output folder, or browse image files produced by Codex.
---
# 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`.
```bash
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
1. Check the default URL first:
```bash
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/`.
2. If the API check fails, check for a running server process:
```bash
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.
3. Verify any reused URL before reporting success:
```bash
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.
4. Start the server if none is running:
```bash
node scripts/server.mjs
```
Keep the process running for the user and read stdout for the URL.
5. Open the browser unless the user asks for URL-only:
```bash
open http://127.0.0.1:8765/
```
## Image Root
Default image root:
```text
~/.codex/generated_images
```
Use a different folder with:
```bash
GALLERY_ROOT=/path/to/images node scripts/server.mjs
```
## Validation
Before declaring the skill healthy after edits, run:
```bash
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.
Files in this package (4)
- SKILL.md 2 KB
- agents/openai.yaml 1 KB
- assets/index.html 39 KB
- scripts/server.mjs 4 KB
Versions
The database has no other skills named codex-image-gallery.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 0a24f520f9f4 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100local-gallery
Show a folder of images and videos in a local browser gallery with folders, lightbox, favorites and live refresh. Use when the user wants to browse, review or present media saved on disk (for example AI-generated images or videos), or when you save generated media into a folder… - 100image
Generates raster images (icons, illustrations, textures) via the logged-in Codex CLI image tool. Use when an agent needs a real image but has no native image generation. - 100codex-cli
Use when an agent needs to delegate a task to the OpenAI Codex CLI from another agent environment such as Claude Code, OpenClaw, or similar. Covers checking whether Codex CLI is installed, running one-off Codex prompts with `codex exec`, resuming sessions, collecting outputs,… - 96pp
从 Pinterest 搜索图片并在浏览器中展示瀑布流画廊。使用 gallery-dl 获取图片链接,生成数据文件,打开浏览器展示。 - 100codex-plan-files
Use when Codex writes, updates, resumes, or looks up a plan. Codex only. Keeps each plan as a Markdown file in one plans folder with a generated index. - 82codex-handoff
交接当前工作到新 Codex 任务。