Repository navigation
Releases
Codex Universal Proxy v0.6.0
This release fixes Responses API validation failures when Codex replays completed web-search markers and retains complete upstream HTTP errors for diagnosis.
It also includes model-picker selection fixes, local realtime voice with Whisper transcription and Kokoro speech, manual push-to-talk and cancellation support, streamed transcript updates, and Linux RTP drain improvements.
Install or upgrade
npm install -g codex-universal-proxy@0.6.0
codex-universal-proxy restartIf upgrading from the legacy codex-ollama-proxy npm package, uninstall that package first to avoid executable-name conflicts. Runtime configuration lives separately under ~/.codex.
Validation
- Static checks pass.
- Full local suite: 401 passed, 4 skipped, zero failures.
- Package installation smoke test passes on macOS.
Published to the npm registry as codex-universal-proxy@0.6.0 with the latest tag. The same installable archive is also attached to this GitHub release.
Web search still requires an available backend. DuckDuckGo CAPTCHA challenges are not resolved by this release.
Codex Universal Proxy v0.5.0
What's Changed
- Persist generated images in session cache by @notOrrytrout in #29
- feat: add provider catalogs and multimodal routing by @bharat2808 in #30
- Fix Windows portability in CI tests by @bharat2808 in #40
- Add cross-platform background service support, runtime paths, CI workflows, and tests by @bharat2808 in #39
- Quote Windows
.cmdpaths with spaces in e2e package smoke helpers by @bharat2808 with @Copilot in #43 - Make tests Windows-friendly and add npm helper for e2e test automation by @bharat2808 in #42
- Restore npm PATH fallback in e2e helpers by @bharat2808 in #44
- windows and linux support for ollama proxy by @bharat2808 in #45
- Feat/anthropic OpenAI model discovery by @bharat2808 in #47
- Rebrand as codex-universal-proxy by @bharat2808 in #48
New Contributors
- @bharat2808 with @Copilot made their first contribution in #43
Full Changelog: v0.4.0...v0.5.0
v0.4.0
Features
- Completion API adaptor for OpenAI Responses-compatible server (Chat Completions-only providers)
- Flexible preset system for any combination of proxy commands with background execution
- Session-based inline image persistence and caching for auto-routed images
- Native Ollama image generation backend via /api/generate
- Separated image generation config so presets work independently
- Async skill index prewarming for faster startup
- Filtering of repeated large Codex instruction blocks
Bug Fixes
- Stabilized streamed Responses lifecycle ordering on [DONE], EOF, and upstream failures
- Scoped image auto-routing to active user turn only, honoring auto_route_image = false
- Hardened inline image persistence with signature validation, size limits, and cache expiry
- Fixed local Ollama capability discovery when /api/tags omits capabilities
- Deduplicated translated function tools with turn-local definition precedence
- Fixed completion adaptor error handling
- Preserved launcher, adaptor, and runtime override settings across restart
- Verified and safely replaced proxy listeners on restart
- Restart proxy by default when starting preset or switching to Ollama
- Fixed preset behavior and config-driven dedupe errors
v0.3.4
Fixes
- Publishes the finalized tool-search compatibility fixes as a new immutable release.
- Rewrites native Codex/Desktop
type: "tool_search"tools into a model-callable function namedtool_search. - Injects the
tool_searchfunction shim when Codex omits nativetool_searchfrom a turn, matching the always-availableweb_searchbehavior. - Preserves deferred
tool_search_outputMCP/plugin namespace tools by exposing discovered tools as callable follow-up functions.
Verification
npm run checknode --test test/*.test.jsnpm pack --dry-run
v0.3.3
Fixes
- Fixed newer Codex/Desktop native
tool_searchexposure where the tool arrives astype: "tool_search"instead of a plain function definition. - The proxy now rewrites native
tool_searchinto a model-callable function tool namedtool_search, then maps the model call back into Codex's nativetool_search_callresponse item. - The proxy also injects the
tool_searchfunction shim when Codex omits nativetool_searchfrom a turn, matching the always-available behavior used forweb_search. - Kept the
tool_search_outputdeferred MCP/plugin namespace tool path fromv0.3.2, so discovered tools are exposed as callable follow-up functions.
Docs
- Updated README pinned install command to
0.3.3. - Documented native managed
tool_searchtranslation and omitted-tool shim injection. - Updated the bundled Codex skill install and deferred MCP notes.
Verification
npm run checknode --test test/*.test.jsnpm pack --dry-run- Live/local probe confirmed empty
tools: []receivesfind_skill,tool_search,web_search,generate_image, andollama_proxy_status.
v0.3.2
Fixes
- Fixed deferred MCP/plugin tools discovered through
tool_searchso returned namespace tools are also exposed as callable top-level functions on the follow-up model request. - Added regression coverage for Storefront Builder-style deferred namespace tools, preventing models from seeing a tool in
tool_search_outputbut being unable to invoke it.
Verification
npm run checknode --test test/*.test.jsnpm pack --dry-run
codex-ollama-proxy v0.3.1
Discoverability
- Updates npm metadata with a benefit-focused description and search keywords for Codex, Ollama, OpenRouter, MCP, tool_search, apply_patch, namespace tools, and Responses API.
- Reworks the README introduction around the user problem: using Codex plugins and MCP tools with local or custom Responses API providers.
- Adds search-oriented README sections for Ollama, OpenRouter, MCP unsupported calls, namespace tool compatibility, tool_search, apply_patch, supported providers, and known limitations.
Verification
npm run checknode --test test/*.test.jsnpm pack --dry-run
codex-ollama-proxy v0.3.0
Features
- Adds configurable upstream Responses API support with
upstream_urland optionalupstream_api_key. - Adds
codex-ollama-proxy upstream --url ...,--api-key ..., and--status. - Routes normal forwarding, streaming continuation loops,
find_skill,web_search, and image-generation prompt enhancement through the configured upstream. - Documents that the upstream must expose a compatible Responses API; Chat Completions-only APIs require a separate adapter.
Verification
npm run checknode --test test/*.test.jsnpm pack --dry-run
codex-ollama-proxy v0.2.1
Install
npm install -g https://github.com/bharat2808/codex-ollama-proxy/releases/download/v0.2.0/codex-ollama-proxy-0.2.0.tgzChangelog
- Added proxy-fulfilled image generation with Gemini/OpenAI backends, prompt enhancement, saved image outputs, and Codex UI image-generation markers.
- Added
ollama_proxy_statusand expanded image-generation CLI configuration/status commands. - Added
find_skillsummary/list support backed by Codex app-server skill discovery, with filesystem fallback for enabled plugin, user, system, and.agentsskills. - Preserved fresh prompt/instruction fields from
models_cache.jsonwhen refreshing the Ollama model catalog. - Improved web search and skill discovery injection so local models can access those tools consistently.
codex-ollama-proxy v0.1.0
Initial GitHub release of codex-ollama-proxy.\n\nInstall:\n\n
bash\nnpm install -g https://github.com/bharat2808/codex-ollama-proxy/releases/download/v0.1.0/codex-ollama-proxy-0.1.0.tgz\n\n\n