Skip to content

v0.1.0 - Image Context Runtime for Codex

Choose a tag to compare

@shixinnt shixinnt released this 11 Aug 09:42
· 12 commits to main since this release

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 mock

Important 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.