codex-ui 2.1.0

Native macOS desktop control for agents: capture windows, inspect controls, click, type, and use your existing Chrome session. MIT licensed; desktop control runs locally without a tool account or hosted service.

Desktop support: macOS 13+, Apple Silicon and Intel. Windows/Linux support installation, schemas, skills, and upgrades; native control is planned.

Try it

Give your agent its first desktop task, or install this exact release:

uv tool install --python 3.12 'https://github.com/ensomniac/codex-ui/releases/download/v2.1.0/ensomniac_codex_ui-2.1.0-py3-none-any.whl'
codex-ui doctor
codex-ui skill install

Requires uv. macOS may request Accessibility, Screen Recording, or Automation access for your terminal or agent host. All installation methods · Ask a question.

Already installed? Run codex-ui upgrade --check, then codex-ui upgrade to get the latest stable release.

Downloads

Use the .whl for Python/uv or the .tgz for the npm bridge. The .tar.gz is the Python source distribution. SHA256SUMS covers the uploaded packages. GitHub's Source code archives are repository snapshots, not installed applications. Package-manager instructions.

2.1.0 — 2026-09-10

• Introduce a quieter visual identity across the website, guide, repository and playground, with a custom window-and-pointer mark.
• Add an on-site command guide, accessible installation controls and a real browser example that reports actual page state.
• Shorten human copy while retaining the founding brief and the invitation for agents to maintain the project.
• Add browser checks for responsive layouts, accessibility, keyboard navigation, clipboard behavior, reduced motion and no-JavaScript use.
• Synchronize public installation URLs with release metadata and publish the site only when its matching packages are available.
• Test actual previous-release upgrades on Apple Silicon, Intel, Windows and Linux.
• Add bot-authored maintainer submissions that keep local signed approval and main branch protections intact.

Native desktop control remains macOS-only. The CLI and native controller behavior are unchanged.

Full changelog

codex-ui 2.0.1

Changelog

2.0.1 — 2026-09-10

• Preserve the running Windows interpreter during upgrades by updating its environment in place.
• Honor an existing GH_TOKEN/GITHUB_TOKEN for authenticated release metadata requests in CI. Normal local use still requires no account.
• Add real upgrade preflight against published artifacts.

Windows users on 2.0.0 should rerun the installer once to receive this fix. macOS/Linux users can use codex-ui upgrade.

2.0.0 — 2026-09-10

First public release of Ryan / Ensomniac's desktop controller.

• Promote the local 1.2.1 script into an MIT-licensed Python package and public repository.
• Preserve macOS native control, the JSON schema and 39 original regression tests.
• Separate portable CLI, models, parser, browser payloads, platform capabilities and lifecycle.
• Add release upgrades, agent skill installation, package-manager bridges, examples and human documentation.
• Replace maintainer-specific screenshot paths with user-relative configurable storage.
• Make unhealthy doctor results return nonzero.
• Fix Chrome page buttons that acknowledge AXPress without firing: click the exact semantic frame once.
• Establish sole-code-owner, locally signed agent review and optional PR notifications.
• Define Windows/Linux expansion with mandatory install and upgrade parity.

The command remains codex-ui. Desktop behavior remains macOS-only. Python internals are not a stable API in this release.

codex-ui 2.0.0

Changelog

2.0.0 — 2026-09-10

First public release of Ryan / Ensomniac's desktop controller.

• Promote the local 1.2.1 script into an MIT-licensed Python package and public repository.
• Preserve macOS native control, the JSON schema and 39 original regression tests.
• Separate portable CLI, models, parser, browser payloads, platform capabilities and lifecycle.
• Add release upgrades, agent skill installation, package-manager bridges, examples and human documentation.
• Replace maintainer-specific screenshot paths with user-relative configurable storage.
• Make unhealthy doctor results return nonzero.
• Fix Chrome page buttons that acknowledge AXPress without firing: click the exact semantic frame once.
• Establish sole-code-owner, locally signed agent review and optional PR notifications.
• Define Windows/Linux expansion with mandatory install and upgrade parity.

The command remains codex-ui. Desktop behavior remains macOS-only. Python internals are not a stable API in this release.