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
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
chore(release): finalize v3.8.8 changelog + add codex-ws dev helper
diegosouzapwb9da7d31763e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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.shnew file mode 100755index 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[@]}" "$@"