Repository navigation
Releases: karlorz/codex-host
Release list
codexhost 0.14.0-2
What's New
Fix the intermittent disappearance of Start voice in Work chats when Desktop retains hidden Chat composers after navigation.
Fixes
- Keep Start voice available in an eligible, idle Work composer when inactive Chat composers remain mounted in the background.
- Continue to respect visible Chat ownership and native account/workspace eligibility while preserving custom-provider configuration and session history.
Compatibility
The button-visibility fix was reproduced and verified live on macOS Desktop 26.1021.31345. It preserves the existing voice routes and does not change model_provider = "custom".
This release verifies restoration of the Start voice button. A complete spoken call, Windows voice, global voice-hotkey launch, screen capture, dictation capture, and the queued-followup Composer/overlay flow retain their separate live-test requirements.
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstallers
Download the installer matching your platform: macOS arm64/x64 or Windows x64/arm64. Fully quit Desktop and reopen codexhost after updating to load the new voice bundles. The voice control may remain hidden while a chat is generating; check it when the composer is idle.
macOS Gatekeeper
If macOS reports that Apple cannot verify the downloaded app, run:
xattr -dr com.apple.quarantine /Applications/codexhost.appThen reopen codexhost.
Contributors
Contributors
Assets 6
codexhost 0.14.0-1
What's New
Restore native voice controls on macOS Desktop 26.1021.31345 while preserving custom-provider configuration, session history, and genuine account/workspace eligibility. Improve voice startup in existing Codex chats, recover Work voice controls after temporary readiness interruptions, and improve queued follow-ups in external Harness chats.
Features
- Restore the native Voice Settings controls for eligible custom-provider setups: microphone and language selection, voice picker, voice-chat hotkey editor, screen-context toggle, and dictation shortcut editor.
Fixes
- Restore Chat voice and qualify the Work gateway integration for Desktop 26.1021.31345. (#9, #10)
- Keep Voice Settings available after a full Desktop restart, including when native assets load in stages.
- Start voice from existing local Codex chats using the selected Work connection, avoiding the provider-related
voice_disabledrejection. - Recover the Work voice button automatically after temporary routing or gateway-readiness interruptions.
- Preserve queued follow-up text through interruption and resume in external Harness chats, and include the text metadata Desktop needs to display queued messages.
- Make Grok permission menus follow Desktop's displayed language when the operating-system language differs.
Compatibility
The new Desktop voice qualification and reported post-restart acceptance cover macOS Desktop 26.1021.31345. They do not qualify Windows Desktop voice. Global voice-hotkey launch, screen capture, dictation capture, and a separate Chat browser-voice call require their own live acceptance checks.
The intentional model_provider = "custom" setting remains unchanged. Native account and workspace restrictions remain authoritative.
Queued follow-ups have automated Host and Renderer regression coverage. A fresh live Composer and overlay-owner test after interruption and resume remains pending; the reported manual voice test does not cover that flow.
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstallers
Download the installer matching your platform from this release: macOS arm64/x64 or Windows x64/arm64. Fully quit Desktop and reopen codexhost after updating so both voice bundles load together.
macOS Gatekeeper
If macOS reports that Apple cannot verify the downloaded app, run:
xattr -dr com.apple.quarantine /Applications/codexhost.appThen reopen codexhost.
Contributors
Contributors
Assets 6
codexhost 0.14.0-0
What's New
This fork release integrates upstream v0.14.0 and fixes duplicate Grok replies and missing written links during voice chats. It adds native Copilot support, Claude Code steering, and improved Harness management and usage statistics while preserving the fork's voice integration.
本次 fork 發行整合 upstream v0.14.0，修復 Grok 回覆重複顯示及語音對話遺漏文字連結的問題。新增 Copilot 原生支援、Claude Code 引導，以及更完善的 Harness 管理與用量統計，並保留 fork 的語音整合。
Features
- Add a native Copilot SDK Harness plugin.
- Steer a running Claude Code Turn natively when supported, with a stop-and-restart fallback when native delivery is uncertain (upstream #572).
- Install and update Harnesses through Host background tasks, update multiple Harnesses from Settings, and open WorkBuddy's official update download.
- Select a Host for usage statistics and aggregate usage in the Desktop timezone (upstream #555).
- Show plugin-declared cache countdowns in Composer (upstream #582).
- Confirm live Grok permission-mode changes.
Fixes
- Show each Grok reply once when live output is reconciled with saved history, including chats started through delegation.
- Keep written Markdown and clickable links visible during voice chats and after ending, reopening, and resuming a voice chat.
- Preserve the new-chat Agent preference when sending messages in existing chats.
- Preserve Claude Code background continuation history, keep asynchronous Agent work within its Turn, and load the CLI's default project and local configuration.
- Preserve Pi's native autonomous Turn boundaries, avoid synthetic OMP Turns for subagent notifications, and fix Pi npm account-import installation failures (upstream #592).
- Retry usage sources that change while being read, and improve countdown and account-quota displays.
- Recognize the Desktop 26.1016 Host registry (upstream #579), use native Desktop services for SSH connections and language settings, and improve WorkBuddy startup compatibility.
- Avoid failing Antigravity Turns when a native error repeats (upstream #554).
- Create a Windows desktop shortcut during installation and fix opaque Wayland input-method candidate borders (upstream #565).
新功能
- 新增基於原生 SDK 的 Copilot Harness 插件。
- 在支援時原生引導正在執行的 Claude Code Turn；無法確認原生交付時，使用停止後重新開始的後備方式（upstream #572）。
- 透過 Host 後台任務安裝與更新 Harness，在設定中批量更新，並開啟 WorkBuddy 官方更新下載。
- 用量統計可選擇 Host，並按 Desktop 時區匯總（upstream #555）。
- Composer 顯示插件聲明的快取倒計時（upstream #582）。
- Grok 即時切換權限模式時加入確認。
修復
- Grok 即時輸出與已儲存歷史同步時，每個回覆只顯示一次，包括透過委派建立的對話。
- 語音對話期間保留 Markdown 文字與可點擊連結；結束、重開及恢復語音後仍可顯示。
- 在現有對話傳送訊息時，保留新對話的 Agent 偏好設定。
- 保留 Claude Code 後台續接歷史，讓非同步 Agent 工作留在所屬 Turn，並載入 CLI 預設的專案與本地設定。
- 保留 Pi 原生自主 Turn 邊界，避免 OMP 子代理通知產生虛構 Turn，並修復 Pi npm 帳號匯入的安裝問題（upstream #592）。
- 讀取期間用量來源有變更時重新讀取，並改善倒計時與帳號額度顯示。
- 識別 Desktop 26.1016 Host 註冊表（upstream #579），透過 Desktop 原生服務處理 SSH 連線與語言設定，並改善 WorkBuddy 啟動相容性。
- Antigravity 重複回傳原生錯誤時，避免令 Turn 失敗（upstream #554）。
- Windows 安裝時建立桌面捷徑，並修復 Wayland 輸入法候選框不透明邊框（upstream #565）。
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release's assets on karlorz/codex-host.
macOS Gatekeeper
If macOS displays "Apple cannot verify this app" after installation, run the following command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-7
What's New
Chat and Work voice follow current Codex Desktop, with native Chat placement and gateway routing for Work. Grok adds Computer Use in Connections and MCP Always allow. Usage, Cursor Fork, Pi, and the selected Model across resume stay reliable.
Chat 与 Work 语音跟随当前 Codex Desktop：原生 Chat 按钮位置正确，Work 走已配置网关。Grok 在连接页提供 Computer Use，MCP 支持 Always allow。用量、Cursor Fork、Pi，以及恢复 / Fork 后的模型选择更稳定。
Features
- Qualify native Chat voice on current Codex Desktop, place it immediately before Send, and keep layout, contrast, and draft selection with the native composer
- Route official Codex Work voice through the configured gateway
- Add a Connections setting for Grok Computer Use
- Project Grok MCP elicitation as a Desktop approval, with Always allow when the native offer includes it
- Check every Harness CLI version from the Connections list, with Update when the Harness supports it
- Name delegated threads from parent and subtask titles (BytePioneer-AI#569)
Fixes
- Keep the selected Model across resume and Fork
- Wait for official Codex recovery on first Host start so Desktop keeps a live Host
- Keep late token counts and user prompts in Usage (BytePioneer-AI#536)
- Stream large zstd Usage rollout frames (BytePioneer-AI#558)
- Open Usage for threads whose titles contain emoji (BytePioneer-AI#559)
- Keep Pi modified files after history rebuild (BytePioneer-AI#567)
- Simplify Pi Fast model eligibility (BytePioneer-AI#575)
- Complete Cursor conversation Fork during a running Turn, a Node 26 snapshot stall, and a path case mismatch (BytePioneer-AI#573)
- Make Cursor Auto's Optimize For selectable as Thinking (BytePioneer-AI#568)
- Check Oh My Pi availability without starting an OMP Session (BytePioneer-AI#577)
- Preserve unknown persisted thread fields
新功能
- 在当前 Codex Desktop 上启用原生 Chat 语音，按钮紧挨发送，并保持与原生 Composer 一致的布局、对比度和草稿选择
- 将官方 Codex 的 Work 语音路由到已配置的网关
- 在连接页增加 Grok Computer Use 设置
- 将 Grok MCP elicitation 投影为 Desktop 审批，并在原生提供 persist always 时显示 Always allow
- 打开连接页时检查全部 Harness CLI 版本，支持更新的 Harness 显示 Update
- 用父任务与子任务标题命名委派 Thread (BytePioneer-AI#569)
修复
- 恢复和 Fork 后保留已选 Model
- 首次启动时等待官方 Codex 恢复，使 Desktop 保持可用 Host
- Usage 保留迟到的 token 计数和用户提示 (BytePioneer-AI#536)
- Usage 可流式读取大型 zstd rollout 帧 (BytePioneer-AI#558)
- 标题含表情的对话可以打开 Usage (BytePioneer-AI#559)
- Pi 重建历史后保留“修改的文件” (BytePioneer-AI#567)
- 简化 Pi Fast 模型资格判断 (BytePioneer-AI#575)
- 修复 Cursor 对话 Fork：运行中 Turn、Node 26 快照卡住、路径大小写 (BytePioneer-AI#573)
- Cursor Auto 的 Optimize For 可作为 Thinking 选择 (BytePioneer-AI#568)
- 检查 Oh My Pi 可用性时不再启动 OMP Session (BytePioneer-AI#577)
- 保留未知的已持久化 Thread 字段
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release:
- Apple Silicon Mac:
codexhost-0.13.3-7-macos-arm64.dmg - Intel Mac:
codexhost-0.13.3-7-macos-x64.dmg - Windows x64:
codexhost-0.13.3-7-windows-x64.exe - Windows ARM64:
codexhost-0.13.3-7-windows-arm64.exe
Linux x64 and ARM64 are available through npm.
macOS Gatekeeper
If macOS displays “Apple cannot verify this app” after installation, run this command and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-6
What's New
Voice settings are now shared between Desktop and the local console, with clearer Chat and Work choices and a managed restart. This release also fixes Grok effort selection, recognizes patched CLI installations, and improves native Chat voice and subagent views.
语音设置现已在 Desktop 与本地控制台之间共享，提供更清晰的 Chat 和 Work 选项及受管理的重启。本版本还修复了 Grok 推理强度选择，识别带补丁的 CLI 安装，并改善原生 Chat 语音与子代理视图。
Features
- Configure Chat and Work voice from a shared Voice settings page in Desktop or the local console, with explicit apply actions and pending-state feedback.
- Restart the managed Desktop from the console or with
codexhost restart, with confirmation and startup status.
Fixes
- Apply the selected Grok reasoning effort to the native CLI, including High and Max for custom models.
- Recognize grokgod-managed Grok and clawgod-managed Claude installations, show their installed versions, and leave updates to their patch managers.
- Keep native ChatGPT voice attached to the correct conversation when starting from a draft or moving between conversations, and select adopted drafts only after the native connection is ready.
- Route external Harness voice through the configured gateway using the native request's model metadata.
- Preserve read-only native subagent views and show each child's observed model and reasoning effort without copying the parent's configuration.
- Wait for the previous controller process to exit during restart and keep console restart controls readable on narrow windows.
新功能
- 在 Desktop 或本地控制台的共享 Voice 设置页中配置 Chat 和 Work 语音，明确应用更改并显示待生效状态。
- 从控制台或通过
codexhost restart重启受管理的 Desktop，提供确认与启动状态。
修复
- 将所选 Grok 推理强度传递给原生 CLI，包括自定义模型的 High 和 Max。
- 识别由 grokgod 管理的 Grok 和由 clawgod 管理的 Claude 安装，显示已安装版本，并由对应补丁管理器负责更新。
- 从草稿启动或切换对话时，让原生 ChatGPT 语音保持关联正确的对话，并在原生连接就绪后再选择已接管的草稿。
- 根据原生请求中的模型信息，将外部 Harness 语音路由至已配置的网关。
- 保留原生子代理视图的只读行为，显示各子代理实际报告的模型和推理强度，不复制父会话的配置。
- 重启时等待旧 Controller 进程退出，并让控制台重启控件在窄窗口中保持清晰可读。
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release:
- Apple Silicon Mac:
codexhost-0.13.3-6-macos-arm64.dmg - Intel Mac:
codexhost-0.13.3-6-macos-x64.dmg - Windows x64:
codexhost-0.13.3-6-windows-x64.exe - Windows ARM64:
codexhost-0.13.3-6-windows-arm64.exe
Linux x64 and ARM64 are available through npm.
macOS Gatekeeper
If macOS displays “Apple cannot verify this app” after installation, run this command and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-5
What's New
This release improves live voice startup on supported Codex Desktop builds, forwards chat-task updates into open calls, and corrects completed Claude Code scout status.
本版本改善受支持 Codex Desktop 版本的 live voice 啟動，將對話任務更新傳送至進行中的通話，並修正 Claude Code 子代理完成狀態。
Fixes
- Create native Desktop voice calls through the configured gateway while retaining the selected external Harness.
- Keep voice startup compatible with Desktop's security policy.
- Forward completed public progress messages and final answers from text or attachment tasks into an open voice call, including work already running when the call opens. Hanging up still lets the agent finish its work.
- Show completed Claude Code scouts as completed when their reports quote background-task wording, while preserving genuine background tasks.
修復
- 原生 Desktop 語音通話透過已設定的 gateway 建立，並保留所選的外部 Harness。
- 語音啟動符合 Desktop 的安全策略。
- 將文字或附件任務已完成的公開進度訊息及最終答案傳送至進行中的語音通話，亦涵蓋開啟通話前已開始的工作；掛線後代理仍可完成任務。
- Claude Code 子代理報告引用背景任務字句時，已完成的子代理會正確顯示為完成，同時保留真正背景任務的執行狀態。
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release: macOS arm64 or x64, or Windows arm64 or x64. Linux arm64 and x64 are available through npm.
macOS Gatekeeper
If macOS displays a verification warning after installation, run this command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-4
What's New
This release improves external-agent voice conversations, including task handoffs, follow-up questions, and live chat updates after hanging up.
Fixes
- Keep replies, tool cards, and completion indicators updating after voice ends, including later text messages in the same chat.
- Start agent work when the voice service hands off a request, without waiting for the final speech transcript.
- Include earlier user and agent messages when reopening voice in an existing external-agent chat.
- Return agent answers through supported voice events so the call can stay connected for follow-up questions.
- Treat delayed stop requests for an old or completed task as already stopped, preserving any newer task.
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release: macOS arm64 or x64, or Windows arm64 or x64. Linux arm64 and x64 are available through npm.
macOS Gatekeeper
If macOS displays a verification warning after installation, run this command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-3
What's New
This release makes the Settings Back button work even when Desktop has no previous page, restores the Codex usage warning preference, and displays Grok Imagine images in conversations.
Features
- Display Grok Imagine-generated images directly in Desktop conversations.
- Restore the Hide Codex usage warning setting, enabled by default, across Composers including Codex threads.
Fixes
- Keep Back enabled while codexhost Settings is open. Clicking Back or using its keyboard shortcut closes Settings and returns to the current conversation.
- Restore Desktop's original Back behavior when Settings closes.
- Keep Composer Send independent of the native account-wide Codex usage warning while preserving other submission restrictions.
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture from this release: macOS arm64 or x64, or Windows arm64 or x64. Linux arm64 and x64 are available through npm.
macOS Gatekeeper
If macOS displays a verification warning after installation, run this command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-1
What's New
Grok Threads started in Codex Desktop receive CodexHost session rules through official ACP _meta.rules. A leftover Desktop Controller after a failed launch no longer blocks the next start.
Codex Desktop 里启动的 Grok Thread 通过官方 ACP _meta.rules 接收 CodexHost 会话规则。失败启动留下的 Desktop Controller 不再挡住下一次启动。
Features
- Deliver CodexHost session rules to Desktop Grok Threads through official ACP
session/new_meta.rules
Fixes
- Recover a leftover Desktop Controller after a failed launch and continue a clean start
新功能
- Desktop Grok Thread 通过官方 ACP
session/new_meta.rules接收 CodexHost 会话规则
修复
- 失败启动留下的 Desktop Controller 会被回收，随后继续干净启动
Installation
npm
npm install -g @karlorz/codexhost-cli
codexhostInstaller
Download the installer matching your OS and CPU architecture:
macOS Gatekeeper
After installing on macOS, if codexhost shows "Apple cannot verify this app" when you open it for the first time, run the following command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
Contributors
Assets 6
codexhost 0.13.3-0
What's New
Tracks upstream 0.13.3 and adds Host-owned live voice for external Harnesses in Codex Desktop. Grok and other Harness Threads can use the native voice button when a realtime gateway is configured.
跟随 upstream 0.13.3，并为 Codex Desktop 中的外部 Harness Thread 提供 Host 托管的原生 live voice。在配置 realtime 网关后，Grok 等 Harness 可使用桌面自带的语音按钮。
Features
- Host-owned native live voice for external Harness Threads (WebRTC audio, configured gateway)
- Carry the Composer Harness selection into the Desktop voice overlay
- Answer empty official attachment, queue, and settings requests on external Threads so non-Desktop clients keep working (BytePioneer-AI#544)
- Treat hyphenated fork counters such as
0.13.3-0and0.13.3-0-1as npm latest and GitHub latest
Fixes
- Keep Codex usage gates compatible with Desktop 26.1002 (BytePioneer-AI#542)
- Connect DeepSeek Harness 0.2.1-rc.1 and rc.2 (BytePioneer-AI#549)
- Bootstrap WorkBuddy encrypted credentials in the bundled CLI (BytePioneer-AI#533)
- Preserve OpenCode streaming part identities (BytePioneer-AI#212)
- Read OpenCode v2 native default variant as the Default option (BytePioneer-AI#528, BytePioneer-AI#537)
新功能
- 外部 Harness Thread 的 Host 托管原生 live voice（WebRTC 音频，使用已配置网关）
- 语音 overlay 沿用 Composer 当前 Harness 选择
- 外部 Thread 对官方 attachment / queue / settings 请求返回空成功，非 Desktop 客户端可继续使用 (BytePioneer-AI#544)
- 连字符 fork 计数器（如
0.13.3-0、0.13.3-0-1）按 npm latest 与 GitHub latest 发布
修复
- Codex usage 门槛适配 Desktop 26.1002 (BytePioneer-AI#542)
- 对接 DeepSeek Harness 0.2.1-rc.1 与 rc.2 (BytePioneer-AI#549)
- 打包 CLI 中引导 WorkBuddy 加密凭据 (BytePioneer-AI#533)
- 保持 OpenCode streaming part 身份 (BytePioneer-AI#212)
- OpenCode v2 原生 default variant 作为 Default 选项 (BytePioneer-AI#528, BytePioneer-AI#537)
Installation
npm
npm install -g @karlorz/codexhost-cli@latest
codexhostInstaller
Download the installer matching your OS and CPU architecture:
macOS Gatekeeper
After installing on macOS, if codexhost shows "Apple cannot verify this app" when you open it for the first time, run the following command in Terminal and reopen codexhost:
xattr -dr com.apple.quarantine /Applications/codexhost.appContributors
Thanks to everyone who contributed to this release:
