v0.1.0 - Image Context Runtime for Codex
Image-only public baseline
- Codex plugin with a bundled local stdio MCP server and durable image-job runtime.
- Text-to-image and image-inspection jobs with bounded text-only MCP results, relative refs, hashes, handoffs, and Job IDs.
- Idempotent submission, restart reconciliation, conservative ambiguous-dispatch recovery, output reservations, and one active worker per Runtime directory.
- Offline deterministic mock Provider by default; optional official OpenAI API Provider.
- Apache-2.0 license, public privacy gates, secret scanning, and Windows/Linux Node.js 22 CI.
Validation
- Plugin runtime and hardening tests: 31/31.
- Repository, benchmark, packaging, and privacy tests: 15/15.
- Fresh public clone, local marketplace install, mock configuration, plugin validator, and skill validator: pass.
- Synthetic 20 × 1 MiB serialized MCP-result proxy: 99.903323% fewer bytes for reference-only results than naive inline-image results.
The synthetic result is not a Codex token, latency, memory, responsiveness, or native-image benchmark.
Install
Clone the repository, then from its root:
codex plugin marketplace add .
codex plugin add codex-image-context-runtime@codex-image-context-runtime
node plugins/codex-image-context-runtime/scripts/configure.mjs --workspace "C:\path\to\your\project" --provider mockImportant boundaries
v0.1 is image-only. It does not patch or intercept Codex built-in image features. The bounded boundary applies only when Codex uses this plugin's MCP tools. Use distinct Runtime directories for simultaneous Codex tasks.