Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

chore(release): finalize v3.8.8 changelog + add codex-ws dev helper

diegosouzapwb9da7d31763e
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb00e7ce29..4c0cec9d6a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,7 @@
---
-## [3.8.8] — 2026-06-01
+## [3.8.8] — 2026-06-03
### Added
@@ -61,6 +61,9 @@
- **Dashboard page redesigns (Nav Restructure)** — agent-skills + omni-skills with a dynamic 42-skill catalog and MCP/A2A discovery (#2827); CLI Code's + CLI Agents + ACP Agents pages (#2839); translator friendly redesign, 5 tabs → 2 (#2847); functional `/batch` + `/batch/files` redesign (#2849); Playground Studio + Search Tools Studio (#2869); memory engine redesign — sqlite-vec + hybrid RRF + Studio UI (#2873). (thanks @diegosouzapw)
- **notion:** add Notion as an MCP context source — 6 tools (`notion_search`, `notion_list_databases`, `notion_get_database`, `notion_query_database`, `notion_read`, `notion_append_blocks`) scoped under `read:notion` / `write:notion`, with dashboard "Context Sources" tab, settings API, and token persistence in `key_value` table (#2959 — thanks @branben)
- **Per-API-key stream default mode** — a per-key setting that forces JSON or SSE as the default response shape (migration `077_api_key_stream_default_mode`), so integrations that expect non-streaming JSON work without client changes. (thanks @JxnLexn)
+- **Codex Responses-over-WebSocket** — opt-out flag `OMNIROUTE_CODEX_WS_ENABLED` (default ON) upgrading Codex Responses traffic to a WebSocket bridge with a clean handshake and bridge-secret auth; the Quota Share endpoints card now surfaces the Responses + codex-WS endpoints. (thanks @diegosouzapw)
+- **Xiaomi MiMo usage tracking** — self-reported usage accounting for Xiaomi MiMo plus a monthly cap preset; DeepSeek USD preset and a Claude plan preset (percent 5h + weekly) seeded into the plan registry. (thanks @diegosouzapw)
+- **API Manager: Normal vs Quota key sections** — the API keys screen now splits keys into Normal and Quota sections in a compact 2-table layout, and the Quota Share screen gains a beta banner, live per-account upstream quota, and a real-time Codex quota view backed by the cascade-safe serialized refresh. (thanks @diegosouzapw)
### Changed
@@ -257,10 +260,13 @@
- **proxy:** resolve registry proxy assignments for combo and key levels (#3048 — thanks @terence71-glitch)
- **providers/web:** wire the session pool for fingerprint rotation on Pollinations / DuckDuckGo (#3049 — thanks @oyi77)
- **providers/claude-web:** add `cf_clearance` cookie support and session-pool fingerprint rotation for Pollinations / DuckDuckGo (#3046 — thanks @oyi77)
+- **usage:** handle MiniMax coding-plan percent quotas (`general`/percent dimension) so MiniMax coding plans report remaining quota correctly. (thanks @diegosouzapw)
+- **home:** pass `providerId` to the quota widget icons so provider brand icons resolve on the home dashboard (#3064 — thanks @xz-dev)
+- **quota:** block `qtSd/*` models for keys with no quota-pool allocation (enforcement Check 2.9), and never flag rotating-refresh providers (Codex/OpenAI) as expired during the quota sync (#3030). (thanks @diegosouzapw)
### 🏆 Contributors
-A special thanks to everyone who contributed to this release — 687 commits since `v3.8.7`:
+A special thanks to everyone who contributed to this release — 746 commits since `v3.8.7`:
| Contributor | PRs / Contribution |
| --- | --- |
@@ -274,7 +280,7 @@ A special thanks to everyone who contributed to this release — 687 commits sin
| [@Lion-killer](https://github.com/Lion-killer) | #2981, #2988 |
| [@JxnLexn](https://github.com/JxnLexn) | per-API-key stream default mode |
| [@androw](https://github.com/androw) | #3017 |
-| [@xz-dev](https://github.com/xz-dev) | #2975 |
+| [@xz-dev](https://github.com/xz-dev) | #2975, #3064 |
| [@S0yora](https://github.com/S0yora) | #2964 |
| [@NekoMonci12](https://github.com/NekoMonci12) | #3008 |
| [@Tentoxa](https://github.com/Tentoxa) | #3010 |
@@ -284,13 +290,14 @@ A special thanks to everyone who contributed to this release — 687 commits sin
| [@dhaern](https://github.com/dhaern) | #2927 |
| [@dangeReis](https://github.com/dangeReis) | #3021 |
| [@bobbyunknown](https://github.com/bobbyunknown) | #3029 |
-| [@CitrusIce](https://github.com/CitrusIce) | #3035 |
+| [@CitrusIce](https://github.com/CitrusIce) | #3035, #3058 |
| [@wussh](https://github.com/wussh) | #3036 |
| [@Chewji9875](https://github.com/Chewji9875) | #3037 |
| [@herjarsa](https://github.com/herjarsa) | #3043 |
+| [@freefrank](https://github.com/freefrank) | #3066 (reported the Docker build failure) |
A special thanks to everyone who contributed code, reviews, and tests for this release:
-@androw, @bobbyunknown, @branben, @charithharshana, @Chewji9875, @CitrusIce, @dangeReis, @dhaern, @diegosouzapw, @guanbear, @herjarsa, @JxnLexn, @Lion-killer, @makcimbx, @NekoMonci12, @NomenAK, @oyi77, @ReqX, @S0yora, @soyelmismo, @Tentoxa, @terence71-glitch, @wussh, @xz-dev
+@androw, @bobbyunknown, @branben, @charithharshana, @Chewji9875, @CitrusIce, @dangeReis, @dhaern, @diegosouzapw, @freefrank, @guanbear, @herjarsa, @JxnLexn, @Lion-killer, @makcimbx, @NekoMonci12, @NomenAK, @oyi77, @ReqX, @S0yora, @soyelmismo, @Tentoxa, @terence71-glitch, @wussh, @xz-dev
---
diff --git a/scripts/codex-ws.sh b/scripts/codex-ws.sh
new file mode 100755
index 0000000000..92ee9b9926
--- /dev/null
+++ b/scripts/codex-ws.sh
@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# =============================================================================
+# codex-ws — roda a OpenAI Codex CLI contra um OmniRoute LOCAL usando o
+# transporte Responses-over-WebSocket (em vez do HTTP da Cloud).
+#
+# POR QUE ESTE WRAPPER EXISTE
+# ---------------------------
+# O OmniRoute expõe um proxy WebSocket para a API de Responses do Codex em
+# ws(s)://<host>/v1/responses
+# A Codex CLI sabe falar esse transporte quando o provider tem
+# `supports_websockets = true` + `wire_api = "responses"`. Mas há DOIS detalhes
+# que quebram o uso ingênuo:
+#
+# 1) A Codex CLI valida o NOME do modelo no cliente. Ids com prefixo de provider
+# (ex.: "codex/gpt-5.5") são REJEITADOS ("model is not supported ... ChatGPT
+# account"). É preciso mandar o id "puro" -> "gpt-5.5". (O OmniRoute, no
+# bridge WS, re-resolve "gpt-5.5" -> provider codex internamente.)
+#
+# 2) A Codex CLI v0.136 carrega TAMBÉM "$CWD/.codex/config.toml" como config
+# "project-local". Se você rodar de um diretório que tenha um .codex (ex.:
+# /root, onde mora a config da Cloud), o `model` daquele arquivo SOBRESCREVE
+# o `model` do seu CODEX_HOME -> você acaba mandando o modelo errado.
+# Por isso forçamos model + model_provider via `-c` (precedência máxima),
+# que vence qualquer config de arquivo (user-level OU project-local).
+#
+# Além disso, no modo `exec` (headless) a CLI exige um diretório "confiável" ou
+# a flag --skip-git-repo-check; o wrapper adiciona a flag automaticamente.
+#
+# USO
+# ---
+# codex-ws "sua pergunta" # abre a TUI interativa (precisa de terminal)
+# codex-ws exec "Responda: PONG" # one-shot headless (CI/validação)
+# codex-ws --help # repassa flags pra Codex CLI
+#
+# Variáveis de ambiente (todas com default; sobrescreva exportando antes):
+# OMNIROUTE_WS_BASE base URL do OmniRoute local (default abaixo)
+# OMNIROUTE_WS_MODEL modelo codex (id puro) (default "gpt-5.5")
+# OMNIROUTE_LOCAL_KEY API key (qualquer valor se REQUIRE_API_KEY=false)
+# CODEX_WS_HOME dir de config isolado da Codex (default ~/.codex-ws)
+# =============================================================================
+
+set -euo pipefail
+
+# ---- Configuração (com defaults seguros) ------------------------------------
+OMNIROUTE_WS_BASE="${OMNIROUTE_WS_BASE:-http://127.0.0.1:20128/v1}" # base do OmniRoute local
+OMNIROUTE_WS_MODEL="${OMNIROUTE_WS_MODEL:-gpt-5.5}" # id PURO (sem "codex/")
+CODEX_WS_HOME="${CODEX_WS_HOME:-$HOME/.codex-ws}" # CODEX_HOME isolado da Cloud
+
+# A Codex CLI lê a key Bearer da env var nomeada em `env_key`. Mantemos um nome
+# próprio para não colidir com OPENAI_API_KEY da config da Cloud.
+export OMNIROUTE_LOCAL_KEY="${OMNIROUTE_LOCAL_KEY:-local}"
+
+# CODEX_HOME isolado: a Codex CLI usa ESTE diretório como config "user-level",
+# deixando a sua ~/.codex (Cloud) totalmente intacta.
+export CODEX_HOME="$CODEX_WS_HOME"
+
+# ---- Garante que a config do CODEX_HOME exista (auto-bootstrap) --------------
+# Só o bloco [model_providers.*] precisa estar aqui; model/model_provider são
+# forçados via -c logo abaixo (por causa do detalhe #2 do cabeçalho).
+if [ ! -f "$CODEX_HOME/config.toml" ]; then
+ mkdir -p "$CODEX_HOME"
+ cat > "$CODEX_HOME/config.toml" <<EOF
+# Gerado por codex-ws.sh — config isolada para o WS local do OmniRoute.
+model = "$OMNIROUTE_WS_MODEL"
+model_provider = "omniroute-local"
+
+[model_providers.omniroute-local]
+name = "OmniRoute Local (WS)"
+base_url = "$OMNIROUTE_WS_BASE" # a URL WebSocket é derivada desta base pela CLI
+wire_api = "responses" # único valor suportado desde fev/2026
+supports_websockets = true # <- liga o transporte Responses-over-WebSocket
+env_key = "OMNIROUTE_LOCAL_KEY" # a CLI lê a key Bearer desta env var
+
+# Marca o HOME como diretório confiável para o modo exec.
+[projects."$HOME"]
+trust_level = "trusted"
+EOF
+fi
+
+# ---- Overrides de precedência máxima ----------------------------------------
+# Vencem qualquer config de arquivo (inclusive a project-local da Cloud em
+# $CWD/.codex/config.toml). É o que garante o modelo certo no transporte certo.
+overrides=(-c model="$OMNIROUTE_WS_MODEL" -c model_provider="omniroute-local")
+
+# ---- Dispatch ---------------------------------------------------------------
+# No modo headless (`exec`) injeta --skip-git-repo-check (senão a CLI recusa
+# rodar fora de um repo git "confiável"). O `shift` remove o "exec" duplicado.
+if [ "${1:-}" = "exec" ]; then
+ shift
+ exec codex exec --skip-git-repo-check "${overrides[@]}" "$@"
+fi
+
+# Modo interativo (TUI) ou qualquer outro subcomando/flag: repassa direto.
+exec codex "${overrides[@]}" "$@"