Repository navigation
Better Codex 0.2.0 beta — Portable Mac host
Pre-releaseRun Better Codex on your own Mac, with optional private Tailscale access from a phone. A cloud server is no longer required.
- A Mac installer prepares verified local Node/Go dependencies, a Native host, the official renderer integration, the front and the local sync relay.
- Workspace roots, names, read policies and project plugins are configurable. Plugin content and writes remain owned by the source project.
- The current core includes the optional-cache improvements, automatic-title service and stale resume-path repair.
- Existing Serve routes are protected. The entry uses an explicit Tailscale login allowlist and does not enable public Funnel.
- Doctor, stopped-host update checks, configuration backups and a source offer for the modified AGPL component are included.
Download Better-Codex-v0.2.0-beta.1-mac.zip, unzip it to a stable location and double-click Install.command. Install and sign in to the official Codex desktop application first. Keep the host terminal open after startup. The first installation downloads dependencies from their original distribution hosts.
For phone access, install and sign in to Tailscale on both devices, stop Better Codex, then run:
"$HOME/.better-codex/better-codex" tailscale --enable
"$HOME/.better-codex/start"Open the printed HTTPS URL. See the repository's installation and plugin guides for custom configuration.
Validated on Apple Silicon with official desktop 26.928.20755 / build 12246, pinned renderer 26.901.51231 / build 8109, and OpenCodex 2.1.0. Fresh cold startup, 43 real local HTTP/WS and reconnect checks, six installation checks, Node boundary tests and the exported Go suite pass. A separate run bootstraps Node and Go with only macOS system tools in PATH.
This is a beta: physical phone/PWA behavior, live Tailscale between devices, Intel startup and signed-in model execution in the clean portable install are not yet verified. The public mobile client is a PWA; this release does not include an Android APK. Official application assets, account credentials, private deployments and session data are not redistributed.
opencodex-2.1.0-better-codex-source.tar.gz contains the complete modified AGPL source, dependency lockfile, license and build instructions. SHA256SUMS.txt covers both downloadable archives.
中文:本版本可在自己的 Mac 上部署,通过 Tailscale 私有访问,无需 CVM;支持工作区、只读策略和项目插件配置。下载 ZIP 后双击 Install.command,按仓库中文说明操作。当前为 beta,真机、TailScale 实网、Intel 和干净安装登录后的模型执行仍保留验收缺口。