Chrome extension backend registration fails
Open 💬 2 comments Opened Jul 8, 2026 by Yuu2427
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What version of Codex CLI is running?
0.134.0
What subscription do you have?
ChatGPT Plus
Which model were you using?
gpt-5.5
What platform is your computer?
macOS 26.4.1
What terminal emulator and version are you using (if applicable)?
Codex Desktop App/ Codex cli（Apple Terminal）
Codex doctor report
codex doctor --json
{
"schemaVersion": 1,
"generatedAt": "1783505505s since unix epoch",
"overallStatus": "ok",
"codexVersion": "0.134.0",
"checks": {
"app_server.status": {
"id": "app_server.status",
"category": "app-server",
"status": "ok",
"summary": "background server is not running",
"details": {
"control socket": "/Users/yuu/.codex/app-server-control/app-server-control.sock",
"daemon state dir": "/Users/yuu/.codex/app-server-daemon",
"mode": "ephemeral",
"pid file": "/Users/yuu/.codex/app-server-daemon/app-server.pid (missing)",
"settings": "/Users/yuu/.codex/app-server-daemon/settings.json (missing)",
"status": "not running",
"update-loop pid file": "/Users/yuu/.codex/app-server-daemon/app-server-updater.pid (missing)"
},
"remediation": null,
"durationMs": 0
},
"auth.credentials": {
"id": "auth.credentials",
"category": "auth",
"status": "ok",
"summary": "auth is configured",
"details": {
"auth file": "/Users/yuu/.codex/auth.json",
"auth storage mode": "File",
"stored API key": "false",
"stored ChatGPT tokens": "true",
"stored agent identity": "false",
"stored auth mode": "chatgpt"
},
"remediation": null,
"durationMs": 0
},
"config.load": {
"id": "config.load",
"category": "config",
"status": "ok",
"summary": "config loaded",
"details": {
"CODEX_HOME": "/Users/yuu/.codex",
"config.toml": "/Users/yuu/.codex/config.toml",
"config.toml parse": "ok",
"cwd": "/Users/yuu",
"enabled feature flags": "shell_tool, unified_exec, shell_snapshot, terminal_resize_reflow, sqlite, hooks, enable_request_compression, multi_agent, apps, tool_suggest, plugins, in_app_browser, browser_use, browser_use_external, computer_use, plugin_sharing, image_generation, skill_mcp_dependency_install, steer, guardian_approval, goals, collaboration_modes, tool_call_mcp_elicitation, personality, fast_mode, tui_app_server, workspace_dependencies",
"feature flag overrides": "none",
"feature flags enabled": "27",
"log dir": "/Users/yuu/.codex/log",
"mcp servers": "2",
"model": "<default>",
"model provider": "openai",
"sqlite home": "/Users/yuu/.codex"
},
"remediation": null,
"durationMs": 0
},
"installation": {
"id": "installation",
"category": "install",
"status": "ok",
"summary": "installation looks consistent",
"details": {
"PATH codex #1": "/opt/homebrew/bin/codex",
"current executable": "/opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/bin/codex",
"install context": "npm (package /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin, bin /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/bin, resources none, path /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/codex-path)",
"managed by bun": "false",
"managed by npm": "true",
"managed package root": "/opt/homebrew/lib/node_modules/@openai/codex",
"npm update target": "/opt/homebrew/lib/node_modules/@openai/codex"
},
"remediation": null,
"durationMs": 96
},
"mcp.config": {
"id": "mcp.config",
"category": "mcp",
"status": "ok",
"summary": "MCP configuration is locally consistent",
"details": {
"configured servers": "2",
"disabled servers": "0",
"stdio servers": "2"
},
"remediation": null,
"durationMs": 0
},
"network.env": {
"id": "network.env",
"category": "network",
"status": "ok",
"summary": "network-related environment looks readable",
"details": {
"proxy env vars present": "HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, http_proxy, https_proxy, all_proxy"
},
"remediation": null,
"durationMs": 0
},
"network.provider_reachability": {
"id": "network.provider_reachability",
"category": "reachability",
"status": "ok",
"summary": "active provider endpoints are reachable over HTTP",
"details": {
"ChatGPT base URL": "https://chatgpt.com/backend-api/ reachable (HTTP 403)",
"reachability mode": "ChatGPT auth"
},
"remediation": null,
"durationMs": 485
},
"network.websocket_reachability": {
"id": "network.websocket_reachability",
"category": "websocket",
"status": "ok",
"summary": "Responses WebSocket handshake succeeded",
"details": {
"DNS": "1 IPv4, 1 IPv6, first IPv6",
"auth mode": "chatgpt",
"connect timeout": "15000 ms",
"endpoint": "wss://chatgpt.com/backend-api/<redacted>",
"handshake result": "HTTP 101 Switching Protocols",
"model provider": "openai",
"models etag present": "true",
"provider name": "OpenAI",
"proxy env vars present": "HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, http_proxy, https_proxy, all_proxy",
"reasoning header": "false",
"server model present": "false",
"supports websockets": "true",
"wire API": "responses"
},
"remediation": null,
"durationMs": 1202
},
"runtime.provenance": {
"id": "runtime.provenance",
"category": "runtime",
"status": "ok",
"summary": "running npm on macos-aarch64",
"details": {
"commit": "unknown",
"current executable": "/opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/bin/codex",
"install method": "npm (package /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin, bin /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/bin, resources none, path /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/codex-path)",
"platform": "macos-aarch64",
"version": "0.134.0"
},
"remediation": null,
"durationMs": 0
},
"runtime.search": {
"id": "runtime.search",
"category": "search",
"status": "ok",
"summary": "search is OK (bundled)",
"details": {
"search command": "/opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/codex-path/rg",
"search command readiness": "file exists",
"search provider": "bundled"
},
"remediation": null,
"durationMs": 0
},
"sandbox.helpers": {
"id": "sandbox.helpers",
"category": "sandbox",
"status": "ok",
"summary": "sandbox configuration is readable",
"details": {
"approval policy": "OnRequest",
"codex-linux-sandbox helper": "none",
"execve wrapper helper": "/Users/yuu/.codex/tmp/arg0/codex-arg0Uzejtw/codex-execve-wrapper",
"filesystem sandbox": "restricted",
"network sandbox": "restricted"
},
"remediation": null,
"durationMs": 0
},
"state.paths": {
"id": "state.paths",
"category": "state",
"status": "ok",
"summary": "state paths and databases are inspectable",
"details": {
"CODEX_HOME": "/Users/yuu/.codex (dir)",
"active rollout files": "2 files, 244507 total bytes, 122253 average bytes",
"archived rollout files": "0 files, 0 total bytes, 0 average bytes",
"goals DB": "/Users/yuu/.codex/goals_1.sqlite (file)",
"goals DB integrity": "ok",
"log DB": "/Users/yuu/.codex/logs_2.sqlite (file)",
"log DB integrity": "ok",
"log dir": "/Users/yuu/.codex/log (missing)",
"sqlite home": "/Users/yuu/.codex (dir)",
"state DB": "/Users/yuu/.codex/state_5.sqlite (file)",
"state DB integrity": "ok"
},
"remediation": null,
"durationMs": 24
},
"terminal.env": {
"id": "terminal.env",
"category": "terminal",
"status": "ok",
"summary": "terminal metadata was detected",
"details": {
"COLORTERM": "truecolor",
"TERM_PROGRAM": "Apple_Terminal",
"color output": "enabled",
"effective locale": "UTF-8",
"stderr is terminal": "true",
"stdin is terminal": "true",
"stdout is terminal": "true",
"terminal": "Apple Terminal",
"terminal size": "80x24",
"terminal version": "470"
},
"remediation": null,
"durationMs": 0
},
"updates.status": {
"id": "updates.status",
"category": "updates",
"status": "ok",
"summary": "update configuration is locally consistent",
"details": {
"cached latest version": "0.143.0",
"check for update on startup": "true",
"last checked at": "2026-07-08T09:21:51.948866Z",
"latest version": "0.143.0",
"latest version status": "newer version is available",
"npm update target": "/opt/homebrew/lib/node_modules/@openai/codex",
"update action": "npm install -g @openai/codex",
"version cache": "/Users/yuu/.codex/version.json"
},
"remediation": null,
"durationMs": 930
}
}
}What issue are you seeing?
在使用 Codex CLI 时，Chrome 插件的后端无法注册。即使 Chrome 扩展已安装并显示 Connected、Native Messaging Host manifest 检查 correct，但运行时始终无法发现 extension backend：agent.browsers.list() 返回 []
agent.browsers.get("extension") 返回 Browser is not available: extension
What steps can reproduce the bug?
Uploaded thread: 019f4108-ec37-7353-9a6f-17fc8e960b29
What is the expected behavior?
应该能正常注册 Chrome extension backend，让 @Chrome 相关指令可以使用真实 Chrome 浏览器（已登录状态）。
Additional information
已尝试彻底清理：删除 ~/.codex 整个目录后重新安装 Codex CLI，仍无法解决。
多次重启系统、重新添加 Chrome 插件、手动执行 setupBrowserRuntime 等操作均无效。
Chrome 版本：149.0.7827.201（Default Profile）
2 Comments
English translation:
What version of Codex CLI is running?
0.134.0
What subscription do you have?
ChatGPT Plus
Which model were you using?
gpt-5.5
What platform is your computer?
macOS 26.4.1
What terminal emulator and version are you using (if applicable)?
Codex Desktop App/ Codex CLI (Apple Terminal)
Codex doctor report
What issue are you seeing?
When using Codex CLI, the backend for the Chrome extension cannot register. Even though the Chrome extension is installed and shows Connected, and the Native Messaging Host manifest check is correct, the extension backend still cannot be discovered at runtime: agent.browsers.list() returns []
agent.browsers.get("extension") returns Browser is not available: extension
What steps can reproduce the bug?
Uploaded thread: 019f4108-ec37-7353-9a6f-17fc8e960b29
What is the expected behavior?
It should be able to register the Chrome extension backend normally, allowing @Chrome-related commands to use the real Chrome browser (in a logged-in state).
Additional information
I have tried a thorough cleanup: deleting the entire ~/.codex directory and then reinstalling Codex CLI, but the issue still cannot be resolved.
Restarting the system multiple times, re-adding the Chrome extension, manually running setupBrowserRuntime, and other operations have all had no effect.
Chrome version: 149.0.7827.201 (Default Profile)
<!-- codex-issue-translator -->
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action