← all repositories
ilysenko/codex-desktop-linux

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.

2.9k stars JavaScript Coding Assistants
codex-desktop-linux
Velocity · 7d
+112
★ / day
Trend
accelerating
star history

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 package builds the right native installer
  • Bundles its own managed Node.js runtime — no distro nodejs package 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 pull and rebuild manually
  • Some features (Computer Use UI, Read Aloud, mobile remote control) are experimental opt-ins, not defaults
  • Hardened systems with noexec /tmp need environment workarounds or the Rust installer and bundled Node runtime will fail
  • Server-gated OpenAI features like gpt-5.5 remain 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.