@bitkyc08/opencodex 1.9.5 → 2.0.0

package/README.ko.md

@@ -1,27 +1,17 @@
-<div align="center">
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png">
-  <img alt="opencodex" src="assets/logo-light.png" width="96" height="96">
-</picture>
-
-# opencodex (`ocx`)
-
-**[OpenAI Codex](https://openai.com/codex)를 위한 범용 프로바이더 proxy — Codex CLI, App, SDK에서 어떤 LLM이든 사용하세요.**
-
-[English](README.md) · **한국어** · [简体中文](README.zh-CN.md)
-
-📖 **[전체 문서 →](https://lidge-jun.github.io/opencodex/ko/)**
+<p align="center">
+  <img src="assets/banner.png" alt="opencodex — 어떤 LLM이든 Codex에서 사용" width="820">
+</p>
 
-</div>
+<p align="center">
+  <a href="README.md">English</a> · <b>한국어</b> · <a href="README.zh-CN.md">简体中文</a> · 📖 <a href="https://lidge-jun.github.io/opencodex/ko/"><b>전체 문서 →</b></a>
+</p>
 
 <p align="center">
-  <img src="assets/dashboard.png" alt="opencodex 대시보드 — 프록시 상태·프로바이더·모델을 보여주는 다크 컨트롤 패널" width="820">
+  <img src="assets/architecture.png" alt="opencodex 아키텍처 — Codex CLI가 opencodex 프록시를 통해 모든 LLM 프로바이더로 라우팅" width="820">
 </p>
 
-Codex는 오직 Responses API(`/v1/responses`)만 사용합니다. opencodex는 Codex와 여러분의 LLM
-프로바이더 사이에 위치하여, 프로토콜을 실시간으로 변환합니다 — streaming, tool 호출, reasoning, 이미지까지
-모두 포함해서 — 양방향으로 동작합니다.
+Codex는 오직 Responses API(`/v1/responses`)만 사용합니다. opencodex는 Codex와 LLM 프로바이더 사이에서
+프로토콜을 실시간으로 변환해 줍니다. streaming, tool 호출, reasoning, 이미지까지 양방향으로 처리합니다.
 
 ```
 Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider
@@ -30,24 +20,34 @@ Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provi
               OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself
 ```
 
+## 지원 플랫폼
+
+| OS | 지원 상태 | 서비스 관리자 |
+|---|---|---|
+| macOS (arm64 / x64) | 완전 지원 | launchd |
+| Linux (x64 / arm64) | 완전 지원 | systemd (user unit) |
+| Windows (x64) | 완전 지원 | Task Scheduler |
+
+[Bun](https://bun.sh) 1.1 이상이 필요합니다. 세 플랫폼 모두 네이티브로 동작합니다 (Windows에서도 WSL 없이 사용 가능합니다).
+
 ## 빠른 시작
 
 ```bash
-# Install
-npm install -g @bitkyc08/opencodex      # or: bun install -g @bitkyc08/opencodex
+# 설치
+npm install -g @bitkyc08/opencodex      # 또는: bun install -g @bitkyc08/opencodex
 
-# Interactive setup (writes config + injects into Codex)
+# 대화형 설정 (config 작성 + Codex에 자동 주입)
 ocx init
 
-# Start the proxy
+# 프록시 시작
 ocx start
 
-# Use Codex normally — it now routes through opencodex
+# Codex를 평소처럼 사용하세요 — opencodex를 통해 라우팅됩니다
 codex "Write a hello world in Rust"
 ```
 
 <details>
-<summary><b><a href="https://bun.sh">bun</a>이 없으신가요?</b> — 먼저 설치하세요 (opencodex는 bun에서 실행됩니다)</summary>
+<summary><b><a href="https://bun.sh">bun</a>이 없으신가요?</b> — 먼저 설치해 주세요 (opencodex는 bun에서 실행됩니다)</summary>
 
 <br/>
 
@@ -59,41 +59,56 @@ curl -fsSL https://bun.sh/install | bash
 powershell -c "irm bun.sh/install.ps1 | iex"
 ```
 
-설치 후 `npm install -g @bitkyc08/opencodex`를 다시 실행하세요. (`ocx` 바이너리는 bun 기반이라 bun이 `PATH`에 있어야 합니다.)
+설치 후 `npm install -g @bitkyc08/opencodex`를 다시 실행하세요. (`ocx` 바이너리는 bun 기반이므로 bun이 `PATH`에 있어야 합니다.)
 
 </details>
 
-`provider/model` 형식으로 라우팅된 특정 모델을 지정할 수 있습니다:
+## 프로바이더 추가하기
+
+가장 쉬운 방법은 웹 대시보드를 이용하는 것입니다.
+
+```bash
+ocx gui        # 브라우저에서 localhost:10100 대시보드를 엽니다
+```
+
+대시보드에서 할 수 있는 일:
+
+1. **프로바이더 선택** — 20개 이상의 내장 프로바이더(Anthropic, Google, xAI, Ollama Cloud 등)에서 원하는 것을 고르세요.
+2. **API 키 입력** — 키를 붙여넣으면 바로 저장됩니다. OAuth를 지원하는 프로바이더는 로그인 버튼으로 인증할 수도 있습니다.
+3. **모델 자동 감지** — 프로바이더를 추가하면 사용 가능한 모델을 자동으로 가져옵니다. Codex 모델 선택기에도 곧바로 반영됩니다.
+
+물론 `~/.opencodex/config.json`을 직접 편집해도 됩니다. 하지만 대시보드가 훨씬 편리합니다.
+
+## 모델 라우팅
+
+`provider/model` 형식으로 원하는 모델을 직접 지정할 수 있습니다:
 
 ```bash
-codex -m "anthropic/claude-opus-4-8" "Explain this stack trace"
-codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
+codex -m "anthropic/claude-opus-4-8"   "이 스택 트레이스를 설명해 줘"
+codex -m "google/gemini-2.5-pro"       "이 코드를 리팩터링해 줘"
+codex -m "ollama-cloud/glm-5.2"        "SQL 마이그레이션 작성"
+codex -m "xai/grok-4"                  "이 PR을 리뷰해 줘"
 ```
 
+프로바이더 이름 없이 모델명만 쓰면 `defaultProvider`로 라우팅됩니다.
+
 ## 주요 기능
 
-- **다섯 가지 adapter**로 Anthropic Messages, Google Gemini, Azure, OpenAI Responses passthrough,
-  그리고 **모든 OpenAI 호환 Chat Completions** 엔드포인트를 지원합니다.
-- **OAuth, API 키, 또는 ChatGPT forward.** xAI / Anthropic / Kimi 계정으로 로그인하거나(토큰은
-  자동 갱신됩니다), `codex login`을 forward 하거나, 키를 붙여넣으세요(`${ENV_VARS}` 지원). 18개 프로바이더의
-  API 키 카탈로그(**Ollama Cloud** 포함)가 기본 내장되어 있습니다.
-- **Codex CLI, TUI, App, SDK에 바로 통합.** `$CODEX_HOME/config.toml`(기본값 `~/.codex/config.toml`)에
-  `[model_providers.opencodex]` 테이블을 주입하고 공유 Codex 모델 카탈로그를 작성하여 라우팅된 모델이
-  Codex 모델 선택기에 표시되게 합니다.
-- **서브에이전트 제어.** `subagentModels` 또는 웹 대시보드에서 최대 5개의 라우팅/네이티브 모델을
-  Codex `spawn_agent` 선택기에 우선 노출할 수 있습니다.
-- **기본은 HTTP/SSE, WebSocket은 opt-in.** 프록시는 Responses WebSocket 엔드포인트를 갖고 있지만,
-  `"websockets": true`일 때만 `supports_websockets`를 광고합니다.
-- **Sidecar.** OpenAI가 아닌 모델에도 ChatGPT 로그인을 통한 `gpt-5.4-mini`를 사용해 실제 **웹 검색**과
-  **이미지 이해** 기능을 제공합니다.
-- 프로바이더, OAuth 로그인, 모델 선택, 요청 로그를 위한 **웹 대시보드**.
+- **다섯 가지 adapter**로 Anthropic Messages, Google Gemini, Azure, OpenAI Responses passthrough, 그리고 **모든 OpenAI 호환 Chat Completions** 엔드포인트를 지원합니다. 프로바이더가 OpenAI 호환 API를 제공한다면 별도 adapter 없이 바로 연결할 수 있습니다.
+- **OAuth, API 키, ChatGPT forward** 중 원하는 인증 방식을 선택하세요. xAI / Anthropic / Kimi 계정으로 OAuth 로그인하면 토큰이 자동 갱신됩니다. `codex login`을 forward 하거나, API 키를 직접 입력해도 됩니다(`${ENV_VARS}` 지원). 18개 프로바이더의 API 키 카탈로그(**Ollama Cloud** 포함)가 기본 내장되어 있습니다.
+- **Codex CLI, TUI, App, SDK에 바로 연결됩니다.** `$CODEX_HOME/config.toml`(기본 `~/.codex/config.toml`)에 `[model_providers.opencodex]` 테이블을 자동 주입하고, 공유 모델 카탈로그를 작성합니다. 라우팅된 모델이 Codex 모델 선택기에 자동으로 나타납니다.
+- **서브에이전트 제어.** `subagentModels` 또는 웹 대시보드에서 최대 5개의 모델을 골라 Codex `spawn_agent` 선택기에 우선 노출할 수 있습니다.
+- **기본은 HTTP/SSE, WebSocket은 opt-in.** 프록시에 Responses WebSocket 엔드포인트가 있지만, `"websockets": true`로 설정할 때만 `supports_websockets`를 광고합니다.
+- **Sidecar로 기능 확장.** OpenAI가 아닌 모델에서도 ChatGPT 로그인을 통한 `gpt-5.4-mini`로 실제 **웹 검색**과 **이미지 이해** 기능을 사용할 수 있습니다.
+- **웹 대시보드** 하나로 프로바이더 관리, OAuth 로그인, 모델 선택, 요청 로그 확인까지 가능합니다.
+- **깔끔한 종료, 잔여물 제로.** `ocx stop`(또는 대시보드의 Stop 버튼)을 누르면 프록시가 종료되고, 백그라운드 서비스가 설치돼 있으면 함께 내려가며, Codex 설정이 원본으로 복원됩니다. 이후 `codex` 명령은 opencodex 없이 원래대로 동작합니다.
 
 ## 프로바이더 및 adapter
 
-| Provider | Adapter | Auth |
+| Provider | Adapter | 인증 방식 |
 |---|---|---|
-| OpenAI (ChatGPT login) | `openai-responses` | forward (키 불필요) |
-| OpenAI (API key) | `openai-responses` | key |
+| OpenAI (ChatGPT 로그인) | `openai-responses` | forward (키 불필요) |
+| OpenAI (API 키) | `openai-responses` | key |
 | Anthropic Claude | `anthropic` | oauth / key |
 | xAI Grok | `openai-chat` | oauth / key |
 | Kimi (Moonshot) | `openai-chat` | oauth / key |
@@ -106,22 +121,22 @@ codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
 ## CLI
 
 ```bash
-ocx init                       # interactive setup
-ocx start [--port 10100]       # start the proxy
-ocx stop                       # stop + restore native Codex
-ocx restore                    # restore without stopping (alias: ocx eject)
-ocx sync                       # refresh models + re-inject into Codex
-ocx status                     # is the proxy running?
-ocx login <xai|anthropic|kimi> # OAuth login
-ocx logout <provider>          # remove a stored login
-ocx gui                        # open the web dashboard
-ocx service <install|start|stop|status|uninstall>   # run as a background service
-ocx update                     # update opencodex to the latest published version
+ocx init                       # 대화형 설정
+ocx start [--port 10100]       # 프록시 시작
+ocx stop                       # 프록시 중지 + Codex 원래 설정 복원
+ocx restore                    # 중지 없이 복원 (별칭: ocx eject)
+ocx sync                       # 모델 갱신 + Codex에 재주입
+ocx status                     # 프록시 실행 중인지 확인
+ocx login <xai|anthropic|kimi> # OAuth 로그인
+ocx logout <provider>          # 저장된 로그인 정보 삭제
+ocx gui                        # 웹 대시보드 열기
+ocx service <install|start|stop|status|uninstall>   # 백그라운드 서비스 (launchd/systemd/schtasks)
+ocx update                     # opencodex를 최신 버전으로 업데이트
 ```
 
 ## 설정
 
-설정은 `~/.opencodex/config.json`에 저장됩니다. 최소 예시:
+설정 파일은 `~/.opencodex/config.json`에 저장됩니다. 최소 설정 예시:
 
 ```json
 {
@@ -144,20 +159,29 @@ ocx update                     # update opencodex to the latest published versio
 }
 ```
 
-WebSocket 전송은 기본적으로 꺼져 있습니다. Codex가 HTTP/SSE 대신 Responses WebSocket 경로를 광고하고
-사용하게 하려면 `"websockets": true`를 명시하세요.
+로컬에서 Ollama나 LM Studio를 실행 중이라면 이렇게 추가하세요:
+
+```json
+{
+  "ollama-local": {
+    "adapter": "openai-chat",
+    "baseUrl": "http://localhost:11434/v1",
+    "apiKey": "",
+    "defaultModel": "llama3.1"
+  }
+}
+```
+
+WebSocket 전송은 기본적으로 꺼져 있습니다. Codex가 HTTP/SSE 대신 Responses WebSocket 경로를 사용하게 하려면 `"websockets": true`를 설정하세요.
 
-모든 필드에 대한 자세한 내용은 **[설정 레퍼런스](https://lidge-jun.github.io/opencodex/ko/reference/configuration/)**
-를 참고하세요.
+모든 필드에 대한 자세한 내용은 **[설정 레퍼런스](https://lidge-jun.github.io/opencodex/ko/reference/configuration/)** 를 참고하세요.
 
 ## 문서
 
-공개 문서 — 설치, 프로바이더, 라우팅, sidecar, Codex 통합, Codex App 모델 선택기,
-CLI/설정 레퍼런스 — 는 [`docs-site/`](./docs-site) 아래의 Astro 사이트이며
-**[lidge-jun.github.io/opencodex](https://lidge-jun.github.io/opencodex/ko/)**에 게시됩니다.
+공개 문서(설치, 프로바이더, 라우팅, sidecar, Codex 통합, Codex App 모델 선택기, CLI/설정 레퍼런스)는 [`docs-site/`](./docs-site)의 Astro 사이트로 빌드되어
+**[lidge-jun.github.io/opencodex](https://lidge-jun.github.io/opencodex/ko/)** 에 게시됩니다.
 
-유지보수용 source of truth는 [`structure/`](./structure)에 있고, 과거 조사/진단 노트는
-[`docs/`](./docs)에 남아 있습니다.
+유지보수용 source of truth는 [`structure/`](./structure)에, 과거 조사/진단 노트는 [`docs/`](./docs)에 있습니다.
 
 ## 개발
 
@@ -165,11 +189,11 @@ CLI/설정 레퍼런스 — 는 [`docs-site/`](./docs-site) 아래의 Astro 사
 git clone https://github.com/lidge-jun/opencodex.git
 cd opencodex
 bun install
-bun run dev          # start the proxy in dev mode
-bun x tsc --noEmit   # typecheck
+bun run dev          # dev 모드로 프록시 시작
+bun x tsc --noEmit   # 타입 체크
 ```
 
-**[기여하기](https://lidge-jun.github.io/opencodex/ko/contributing/)**를 참고하세요.
+**[기여하기](https://lidge-jun.github.io/opencodex/ko/contributing/)** 를 참고하세요.
 
 ## 라이선스
 

package/README.md

@@ -1,27 +1,21 @@
-<div align="center">
+<h3 align="center">make codex open!</h3>
+<p align="center"><code>npm install -g @bitkyc08/opencodex</code> · <code>ocx start</code> · <b>localhost:10100</b></p>
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png">
-  <img alt="opencodex" src="assets/logo-light.png" width="96" height="96">
-</picture>
-
-# opencodex (`ocx`)
-
-**Universal provider proxy for [OpenAI Codex](https://openai.com/codex) — use any LLM with Codex CLI, App, and SDK.**
-
-[English](README.md) · [한국어](README.ko.md) · [简体中文](README.zh-CN.md)
-
-📖 **[Full documentation →](https://lidge-jun.github.io/opencodex/)**
+<p align="center">
+  <img src="assets/banner.png" alt="opencodex — Universal provider proxy for Codex, use any LLM" width="820">
+</p>
 
-</div>
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · 📖 <a href="https://lidge-jun.github.io/opencodex/"><b>Full documentation →</b></a>
+</p>
 
 <p align="center">
-  <img src="assets/dashboard.png" alt="opencodex dashboard — a dark provider control panel showing live proxy status, routed providers, and available models" width="820">
+  <img src="assets/architecture.png" alt="opencodex architecture — Codex CLI routes through opencodex proxy to any LLM provider" width="820">
 </p>
 
-Codex only speaks the Responses API (`/v1/responses`). opencodex sits between Codex and your LLM
-provider, translating the protocol on the fly — streaming, tool calls, reasoning, and images included
-— in both directions.
+Use Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama, or any other LLM with Codex — without waiting for OpenAI to add support.
+
+opencodex is a lightweight local proxy that translates Codex's Responses API into whatever your provider speaks. Streaming, tool calls, reasoning tokens, images — everything works, in both directions.
 
 ```
 Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider
@@ -73,30 +67,61 @@ Then re-run `npm install -g @bitkyc08/opencodex`. (The `ocx` binary is bun-nativ
 
 </details>
 
-Target a specific routed model with the `provider/model` form:
+## Add a provider
+
+The fastest way to add a provider is through the web dashboard:
 
 ```bash
+ocx gui
+```
+
+This opens the dashboard at `http://localhost:10100`. From there:
+
+1. Click **"Add Provider"**
+2. Pick from **40+ built-in providers** — or enter a custom OpenAI-compatible endpoint
+3. Paste your API key (or log in via OAuth for Anthropic, xAI, and Kimi)
+4. Models are **auto-discovered** from the provider's `/v1/models` endpoint
+
+Your new provider is ready to use immediately. No restart needed.
+
+You can also add providers through `ocx init` (interactive CLI) or by editing `~/.opencodex/config.json` directly.
+
+## Model routing
+
+Target any configured provider and model using the `provider/model` syntax:
+
+```bash
+# Use Claude Opus through Anthropic
 codex -m "anthropic/claude-opus-4-8" "Explain this stack trace"
-codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
+
+# Use Gemini through Google
+codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"
+
+# Use GLM through Ollama Cloud
+codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"
+
+# Use a local model through Ollama
+codex -m "ollama/llama3" "Refactor this function"
 ```
 
+When you omit the `provider/` prefix, opencodex routes to the default provider — or auto-matches based on the model name pattern (e.g., `claude-*` routes to Anthropic, `gpt-*` routes to OpenAI).
+
+Routed models also appear in the **Codex App** model picker with per-model reasoning effort controls:
+
+<p align="center">
+  <img src="assets/codex-app-picker.png" alt="Codex App showing opencodex routed models with reasoning effort picker" width="480">
+</p>
+
 ## Highlights
 
-- **Five adapters** cover Anthropic Messages, Google Gemini, Azure, the OpenAI Responses passthrough,
-  and **every OpenAI-compatible Chat Completions** endpoint.
-- **OAuth, API key, or ChatGPT forward.** Log in with your xAI / Anthropic / Kimi account (tokens
-  auto-refresh), forward your `codex login`, or paste a key (`${ENV_VARS}` supported). An 18-provider
-  API-key catalog (incl. **Ollama Cloud**) is built in.
-- **Drops into Codex CLI, TUI, App, and SDK.** Injects a `[model_providers.opencodex]` table into
-  `$CODEX_HOME/config.toml` (default `~/.codex/config.toml`) and writes a shared Codex model catalog
-  so routed models appear in Codex model pickers.
-- **Subagent control.** Feature up to five routed or native models in Codex's `spawn_agent` picker
-  from `subagentModels` or the web dashboard.
-- **HTTP/SSE by default, WebSocket opt-in.** The proxy has a Responses WebSocket endpoint, but it
-  only advertises `supports_websockets` when `"websockets": true` is set.
-- **Sidecars.** Give non-OpenAI models real **web search** and **image understanding** via a
-  `gpt-5.4-mini` over your ChatGPT login.
-- **Web dashboard** for providers, OAuth login, model selection, and request logs.
+- **Use any LLM with Codex.** 5 protocol adapters cover Anthropic Messages, Google Gemini, Azure, OpenAI Responses passthrough, and every OpenAI-compatible Chat Completions endpoint — that's 40+ providers out of the box.
+- **Log in once, skip the API key.** OAuth support for xAI, Anthropic, and Kimi means you can authenticate with your existing account. Tokens auto-refresh. Or forward your `codex login`, paste an API key, or use `${ENV_VAR}` references — your call.
+- **Works everywhere Codex does.** Injects into Codex CLI, TUI, App, and SDK automatically. Routed models show up in Codex's model picker just like native ones.
+- **Delegate to the right model.** Feature up to five routed or native models in Codex's subagent picker from the dashboard or config — route complex tasks to a reasoning model, fast tasks to a cheap one.
+- **Give any model superpowers.** Non-OpenAI models get real web search and image understanding via a `gpt-5.4-mini` sidecar over your ChatGPT login.
+- **See what's happening.** The web dashboard shows providers, OAuth status, model selection, and a live request log — no more guessing why a request failed.
+- **Runs in the background.** Install as a system service (launchd / systemd / Task Scheduler) and forget about it. The proxy starts on boot and stays out of your way.
+- **Clean exit, zero residue.** `ocx stop` (or the dashboard's Stop button) shuts down the proxy, stops the background service if one is installed, and restores Codex to its original configuration. Plain `codex` works exactly as it did before — no leftover config, no orphaned processes.
 
 ## Providers & adapters
 
@@ -108,11 +133,13 @@ codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"
 | xAI Grok | `openai-chat` | oauth / key |
 | Kimi (Moonshot) | `openai-chat` | oauth / key |
 | Google Gemini | `google` | key |
-| Azure OpenAI | `azure` | key |
+| Azure OpenAI | `azure-openai` | key |
 | Ollama Cloud + 17-provider catalog | `openai-chat` | key |
 | Ollama / vLLM / LM Studio (local) | `openai-chat` | key (usually blank) |
 | Any OpenAI-compatible endpoint | `openai-chat` | key |
 
+Plus DeepSeek, Groq, OpenRouter, Together, Fireworks, Cerebras, Mistral, Hugging Face, NVIDIA NIM, MiniMax, Qwen Portal, and more. See the full list with `ocx init` or in the [provider docs](https://lidge-jun.github.io/opencodex/reference/configuration/).
+
 ## CLI
 
 ```bash
@@ -131,7 +158,7 @@ ocx update                     # update opencodex to the latest published versio
 
 ## Configuration
 
-Config lives at `~/.opencodex/config.json`. Minimal example:
+Config lives at `~/.opencodex/config.json`. Here's a typical multi-provider setup:
 
 ```json
 {
@@ -154,20 +181,40 @@ Config lives at `~/.opencodex/config.json`. Minimal example:
 }
 ```
 
-WebSocket transport is off by default. Set `"websockets": true` only if you want Codex to advertise
-and use the Responses WebSocket path instead of HTTP/SSE.
+Local models work too. Point opencodex at any OpenAI-compatible server running on your machine:
+
+```json
+{
+  "port": 10100,
+  "defaultProvider": "ollama",
+  "providers": {
+    "ollama": {
+      "adapter": "openai-chat",
+      "baseUrl": "http://localhost:11434/v1",
+      "authMode": "key",
+      "apiKey": "",
+      "defaultModel": "llama3"
+    },
+    "vllm": {
+      "adapter": "openai-chat",
+      "baseUrl": "http://localhost:8000/v1",
+      "authMode": "key",
+      "apiKey": "",
+      "defaultModel": "Qwen/Qwen3-32B"
+    }
+  }
+}
+```
+
+WebSocket transport is off by default. Set `"websockets": true` only if you want Codex to advertise and use the Responses WebSocket path instead of HTTP/SSE.
 
-See the **[Configuration reference](https://lidge-jun.github.io/opencodex/reference/configuration/)**
-for every field.
+See the **[Configuration reference](https://lidge-jun.github.io/opencodex/reference/configuration/)** for every field.
 
 ## Documentation
 
-The public docs — install, providers, routing, sidecars, Codex integration, Codex App model picker,
-and CLI/config reference — are built from [`docs-site/`](./docs-site) and published to
-**[lidge-jun.github.io/opencodex](https://lidge-jun.github.io/opencodex/)**.
+The public docs — install, providers, routing, sidecars, Codex integration, Codex App model picker, and CLI/config reference — are built from [`docs-site/`](./docs-site) and published to **[lidge-jun.github.io/opencodex](https://lidge-jun.github.io/opencodex/)**.
 
-Maintainer source-of-truth notes live under [`structure/`](./structure). Historical investigations
-remain under [`docs/`](./docs).
+Maintainer source-of-truth notes live under [`structure/`](./structure). Historical investigations remain under [`docs/`](./docs).
 
 ## Development