macOS
Homebrew Caskverified · 100%
brew install --cask opencodexlocal Homebrew cask metadata
cask
Install opencodex with Homebrew Cask
Proxy that connects AI coding agents to other LLM providers. Version 2.97.0 via Homebrew Cask; verified from local package data.
install
Additional install commands
overview
Package summary
Proxy that connects AI coding agents to other LLM providers
Project links
Commands and aliases
No executable aliases were found in the local package database.
From the blog
history
Project history and usage
OpenCodex is a local proxy and routing layer that lets AI coding clients use multiple hosted or local model providers through their existing interfaces.
Project history
OpenCodex was created as a local universal-provider proxy for AI coding agents. Its scope expanded to translate between OpenAI Responses, OpenAI-compatible, and Anthropic-style interfaces while preserving streaming, tool calls, reasoning data, and images.
Later development added provider presets, OAuth login, model combinations, account pooling, sub-agent routing, sidecars for search and vision, a management dashboard, desktop packaging, and explicit integrations for multiple coding clients.
Adoption history
OpenCodex broadened from a Codex-oriented local proxy into a gateway supporting Codex CLI, Codex App and SDK workflows, Claude Code, Claude Desktop, Grok Build, and other compatible clients. It is distributed as a desktop application, standalone executable, and npm-installed command-line tool.
The project maintains provider presets, adapters, client integrations, and a dashboard so users can change model backends while retaining their preferred coding-agent interface.
How it is used
Users run the initialization wizard, select a provider and model, supply an API key or OAuth login, and optionally let OpenCodex inject its local endpoint into Codex configuration. The proxy can then be started as a foreground command or managed background service.
Advanced workflows route different models or tasks to different providers, define failover or weighted combinations, expose routed models to sub-agents, and inspect live requests through the dashboard. Stopping or ejecting the integration restores native Codex routing.
Why package nerds care
OpenCodex exemplifies the rapidly growing package layer between AI coding agents and model providers. It turns protocol translation, provider authentication, model discovery, routing, failover, and account selection into a locally managed service.
Its reversible edits to Codex configuration and catalogs are especially relevant to package maintainers: starting the proxy integrates it with existing clients, while stop, restore, and eject operations remove generated routing state without deleting the user's native configuration.
Timeline
- Initial project: OpenCodex provided a local provider proxy for Codex workflows.
- Subsequent development: Support expanded to Claude Code, desktop clients, provider OAuth, routing combinations, account pools, sidecars, and managed sub-agent catalogs.
Related projects
- OpenAI Codex is a primary client whose configuration and model catalog OpenCodex can manage reversibly.
- Claude Code is another officially documented client and can route its inference traffic through OpenCodex.
- Provider services and local model servers sit upstream of OpenCodex through built-in or custom adapters.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for opencodex. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
$OPENCODEX_HOME/config.json (default ~/.opencodex/config.json)$CODEX_HOME/config.toml (default ~/.codex/config.toml)$CODEX_HOME/opencodex.config.toml (default ~/.codex/opencodex.config.toml)$CODEX_HOME/opencodex-catalog.json (default ~/.codex/opencodex-catalog.json)- Windows
%USERPROFILE%\.opencodex\config.json%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\opencodex.config.toml%USERPROFILE%\.codex\opencodex-catalog.json
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
$OPENCODEX_HOME/auth.json (default ~/.opencodex/auth.json)- Windows
%USERPROFILE%\.opencodex\auth.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
| No executable data was present. | |||
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version2.97.0
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://github.com/lidge-jun/opencodex
- infoNo package-manager update timestamp was available.low confidence
- infoNo cached GitHub release or tag data was available.https://github.com/lidge-jun/opencodexnone confidence
install metadata
Package metadata
| Package key | cask:opencodex |
|---|---|
| Version | 2.97.0 |
| Package manager | Homebrew Cask |
| Package manager page | https://formulae.brew.sh/cask/opencodex |
| Homepage | https://opencodex.me/ |
| Repository | https://github.com/lidge-jun/opencodex |
| Upstream docs | https://opencodex.me/ |
| Source archive | https://github.com/lidge-jun/opencodex/releases/download/v2.97.0/OpenCodex-2.97.0-macos.dmg |
| SHA-256 | 0faf0bf29766009fe3e36f33802858d4965d3b65636a6e6eecb7a6149651f467 |
| Bottle | not recorded |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew cask API |
|---|---|
| Tap | homebrew/cask |
| Full Token | opencodex |
| Names |
|
| Depends On | |
| Artifacts | |
| Auto Updates | yes |
| Deprecated | no |
| Disabled | no |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment