OpenAI's macOS-only Codex, repackaged for the rest of us
An unofficial build pipeline that converts upstream DMGs into native Linux packages with auto-updates, Nix flakes, and a growing pile of Linux-only extras.

What it does
Takes OpenAI’s macOS-only Codex Desktop, rips apart the upstream Codex.dmg, and rebuilds it as a runnable Linux Electron app. Spits out native .deb, .rpm, .pkg.tar.zst, or local AppImage builds depending on your distro. Includes a codex-update-manager that detects newer upstream releases and rebuilds native packages locally so you’re not stuck on whatever version you first installed.
The interesting bit
The project treats the macOS app as a source of truth it can’t control, then layers on Linux-specific integrations through an opt-in feature system. There’s a guided setup wizard that probes your desktop environment, checks ydotool readiness for Computer Use, and even offers experimental mobile remote-control patches for Android host access that upstream limits to macOS. Nix users get declarative Home Manager modules and additive feature variants like nix run ...#computer-use-ui-remote-mobile-control.
Key highlights
- Auto-detects distro and package format; one
make packagebuilds the right native installer - Bundles its own managed Node.js runtime — no distro
nodejspackage needed - Optional Linux Computer Use via Rust MCP backend for screenshots, accessibility, and input synthesis
- Chrome/Brave/Chromium native messaging host auto-installs with the app
- Systemd user service for auto-updates on anything systemd-based
- Nix flake with Cachix cache support and feature-specific app variants
Caveats
- AppImage builds skip the auto-updater entirely; you must
git pulland rebuild manually - Some features (Computer Use UI, Read Aloud, mobile remote control) are experimental opt-ins, not defaults
- Hardened systems with
noexec/tmpneed environment workarounds or the Rust installer and bundled Node runtime will fail - Server-gated OpenAI features like
gpt-5.5remain account-limited; rebuilding the package won’t unlock them
Verdict Worth a look if you want Codex Desktop on Linux without running a macOS VM, and especially if you’re already in the Nix ecosystem. Skip it if you need turnkey cross-platform parity or get nervous about unofficial repackaging of a moving upstream target.
Frequently asked
- What is ilysenko/codex-desktop-linux?
- An unofficial build pipeline that converts upstream DMGs into native Linux packages with auto-updates, Nix flakes, and a growing pile of Linux-only extras.
- Is codex-desktop-linux open source?
- Yes — ilysenko/codex-desktop-linux is open source, released under the MIT license.
- What language is codex-desktop-linux written in?
- ilysenko/codex-desktop-linux is primarily written in JavaScript.
- How popular is codex-desktop-linux?
- ilysenko/codex-desktop-linux has 2.9k stars on GitHub and is currently accelerating.
- Where can I find codex-desktop-linux?
- ilysenko/codex-desktop-linux is on GitHub at https://github.com/ilysenko/codex-desktop-linux.