Repository navigation
codexhost 0.18.0
What's New
🎉🎉 Major update 🎉🎉: codexhost now works in your browser and on your phone, not only inside Codex Desktop. The Web app shows the same conversations as Desktop, so you can check progress, answer questions and approve actions from any device while your computer runs the tasks. Other tools can also delegate work to your Agents.
🎉🎉 重大更新 🎉🎉: codexhost 现在不只在 Codex Desktop 里使用,还可以在浏览器和手机上使用。Web 与 Desktop 共用同一批会话,任务在电脑上运行,你可以在任何设备上查看进度、回答提问、处理审批。其他工具也可以把任务委派给你的 Agent。
Features
- Web app: use codexhost in any browser without Codex Desktop. Chat with Agents, upload files and images, browse project files and use terminals (#518)
- Phone access: connect over Wi-Fi, Tailscale or Relay, and install the Web app on your phone or computer like a regular app. The official Relay requires an invitation code; self-hosting is supported. Your computer must stay on and connected (#518)
- One conversation, two interfaces: Desktop and Web share history, progress, approvals and settings, including official Codex conversations. Closing either interface does not stop background tasks (#518, #772)
- Session tabs and faster lists: keep stable session tabs with an idle timeout, clear them without leaving the page, and load long conversation lists faster
- Desktop SSH and Remote Control sessions in Web: open them from the browser (#771, #776)
- Push notifications: get phone and browser notifications for finished, failed and waiting conversations
- Delegation for external clients: tools such as Grokbot can register, start delegated work on other Harnesses over MCP and receive events. Watches survive Host restarts (#727, #726, #788)
- Settings and Console: a separate "Phone & browser" settings page, an "Other computers (SSH)" page, and large "Open Web" and "Remote access" buttons in the Console
- Compact Antigravity conversations with its native context compaction (#747)
- Desktop 26.1106 support (#811)
Fixes
- Keep Web and Desktop consistent for titles, pinned and archived conversations, commands, approvals, queued messages, Fast mode, questions and answers (#772, #786)
- Make code changes, the Composer, the sidebar and scrolling work better on phones
- Make the Windows background service and terminals start and clean up reliably (#778)
- Recover cleanly after an npm reinstall: running Host and Web services are recognized again, so
codexhost statusandcodexhost stopreport and stop them correctly (#806) - Support newer DeepSeek Harness versions, from 0.2.1-rc.3 through 0.2.2-rc.1 (#742)
- Make Desktop's compact action and conversation targeting work with the selected Agent (#759, #755, #758)
- Fix Antigravity conversation saving, remove its default 30-minute timeout and recover missing native databases (#763, #761, #775)
- Inherit the source session's model settings when forking Codex (#794)
- Allow Remote SSH tasks to use the desktop login session on macOS (#790)
- Resolve POSIX-style drive paths in workspace file and image links (#780)
- Preserve special Unicode characters in OMP history (#743) and show Qoder's configured context window (#735)
- Fix the application version passed when starting Z Code (#754)
- Recover iOS PWA push subscriptions after they rotate
新功能
- Web 端: 不用打开 Codex Desktop,在任何浏览器里就能使用 codexhost:和 Agent 聊天、上传文件和图片、浏览项目文件、使用终端 (#518)
- 手机访问: 通过同一 Wi-Fi、Tailscale 或 Relay 连接电脑,还可以把 Web 安装到手机或电脑桌面,像普通应用一样打开。官方 Relay 需要邀请码,也支持自建;使用时电脑需保持开机联网 (#518)
- 两端共用会话: Desktop 和 Web 共享历史、进度、审批和设置,包括官方 Codex 会话。关闭其中一个界面,不会停止后台任务 (#518, #772)
- 会话标签页与更快的列表: 稳定的会话标签页支持空闲超时,可在不离开当前页面的情况下清除标签,长会话列表加载更快
- Web 中打开 Desktop 的 SSH 和 Remote Control 会话 (#771, #776)
- 推送通知: 会话完成、失败或等待处理时,手机和浏览器都会收到通知
- 面向外部客户端的委派: Grokbot 等工具可以注册身份,通过 MCP 把任务委派给其他 Harness 并接收事件;监听可跨 Host 重启恢复 (#727, #726, #788)
- 设置与控制台: 新增独立的“手机与浏览器”设置页,原“远程连接”改名为“其他电脑(SSH)”;控制台新增醒目的“打开 Web”和“远程访问”按钮
- Antigravity 支持压缩上下文,使用它的原生压缩能力 (#747)
- 支持 Desktop 26.1106 (#811)
修复
- Web 与 Desktop 的标题、置顶和归档状态、命令、审批、排队消息、Fast 模式以及提问与回复保持一致 (#772, #786)
- 手机上更容易查看代码改动,输入区、侧栏和滚动体验更好
- Windows 后台服务和终端的启动与清理更可靠 (#778)
- npm 覆盖安装后可正确恢复:运行中的 Host 和 Web 服务会被重新识别,
codexhost status和codexhost stop能如实报告并停止它们 (#806) - 兼容新版 DeepSeek Harness,支持 0.2.1-rc.3 至 0.2.2-rc.1 (#742)
- Desktop 的压缩按钮和会话定位可正确使用当前 Agent (#759, #755, #758)
- 修复 Antigravity 会话保存失败,移除默认 30 分钟超时,并恢复丢失的原生数据库 (#763, #761, #775)
- 分叉 Codex 会话时继承来源会话的模型设置 (#794)
- macOS 上远程 SSH 任务可使用桌面登录会话 (#790)
- 工作区文件和图片链接可解析 POSIX 风格的盘符路径 (#780)
- OMP 历史正确保留特殊 Unicode 字符 (#743),Qoder 正确显示已配置的上下文窗口 (#735)
- 修复启动 Z Code 时传入的应用版本 (#754)
- iOS PWA 的推送订阅轮换后可自动恢复
Installation
npm
npm install -g @codexhost/cli
codexhost # start Codex Desktop
codexhost web # start Web and open it in your browser
codexhost stop # stop all codexhost background servicesTo upgrade an existing npm installation, run codexhost update, or run codexhost stop before installing over it.
Web is available at http://127.0.0.1:4400 on your computer. Keep access tokens, login links and QR codes private: anyone with access can operate your computer.
Installer
Download the installer matching your OS and CPU architecture from this release. After installing, open codexhost; Web is available at http://127.0.0.1:4400.
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: