Weirdo Foundry

Weirdo Foundry is stateful imagegen tooling for Codex.

It is the part image generation always seems to need five minutes too late: memory, taste notes, reusable prompt contracts, reference tracking, version history, review rubrics, multi-agent handoffs, and a sane place for finished files to land.

Codex still does the creative work. Imagegen still makes the pixels. Weirdo Foundry keeps the production brain running in the background so every batch gets faster, tighter, and less wasteful.

Why This Is Awesome

Image generation is fun until the thread gets long, the best prompt is buried somewhere above the fold, the fourth variant almost matches the first, and the final files are scattered across three places with names like image-7-final-final-maybe.png.

Weirdo Foundry fixes that.

• It remembers the project, not just the prompt.
• It turns messy creative direction into compact prompt contracts.
• It keeps style locks and reference bibles close, so a series can actually feel like a series.
• It records variants, critiques, winners, failures, and lessons learned.
• It helps Codex compare similar images instead of rerolling blindly.
• It can prepare task briefs for multiple agents when a project needs more hands.
• It moves or copies approved files into delivery folders, including Dropbox-style sync locations.

The result is simple: less context retyping, fewer lost decisions, faster iteration, and more consistent finished work.

What It Does

• Tracks image projects, batches, jobs, references, variants, critiques, and exports.
• Compiles token-efficient prompt contracts for repeatable imagegen sessions.
• Preserves consistency through style locks, saved style kits, and reference bibles.
• Scores work with rubric packs and ranks winners.
• Caches perceptual hashes for visual similarity and near-duplicate checks.
• Creates handoff capsules, generation packets, and agent task briefs.
• Imports recent outputs, builds contact sheets, makes galleries, and exports variants.
• Copies or moves project files into local delivery destinations.

How To Call It In Codex

Once the plugin is installed and enabled, ask Codex to use Weirdo Foundry for any stateful image project:

Use Weirdo Foundry for this image batch.

Or be more specific:

Use Weirdo Foundry to create a style-locked set of 12 weird sticker concepts,
rank the strongest ones, and deliver the accepted files to my Dropbox folder.

For one-off image requests, Codex can still generate normally. For anything that needs consistency, batching, rerolls, review, delivery, or future reuse, Weirdo Foundry is the better tool.

CLI

python3 scripts/weirdo_foundry.py status
python3 scripts/weirdo_foundry.py create-project --title "Image project"
python3 scripts/weirdo_foundry.py production-step --concept "weird badge mascot" --count 4
python3 scripts/weirdo_foundry.py deliver-files --project <project-id> --destination dropbox --status accepted

Projects are stored by default in:

~/Pictures/Weirdo Foundry

Set WEIRDO_FOUNDRY_ROOT to use a different library location.

Structure

• .codex-plugin/plugin.json defines the Codex plugin manifest.
• .mcp.json registers the Weirdo Foundry MCP server.
• scripts/weirdo_foundry.py contains the stateful library and CLI.
• scripts/mcp_server.py exposes MCP tools, prompts, and resources.
• skills/weirdo-foundry/SKILL.md tells Codex when and how to use the plugin.
• assets/ contains plugin icons and screenshots.

What Ships In The Box

• Project memory for repeat image workflows.
• Prompt contracts for speed and token efficiency.
• Style locks for consistency.
• Reference bibles for reusable art direction.
• Rubric packs for repeatable taste checks.
• Similarity search for avoiding duplicate-ish variants.
• Multi-agent planning helpers for bigger production runs.
• Delivery destinations for moving finished files out of the thread workspace.

Tiny Philosophy

Weirdo Foundry does not replace the artist, the prompt, Codex, or imagegen.

It replaces the boring part where you keep re-explaining what already worked.