explaingit

gxanshu/codex-desktop-appimage

★ 2JavaScriptAudience · developerComplexity · 2/5ActiveSetup · easy

TLDR

Unofficial Linux AppImage build of OpenAI Codex Desktop, repackaged daily by a GitHub Action from the macOS DMG. x86_64 only, self-updating.

Mindmap

mindmap
  root((codex-desktop-appimage))
    Inputs
      Upstream Codex.dmg
      GitHub Action schedule
    Outputs
      Self-updating AppImage
      GitHub Releases
    Use Cases
      Run Codex on Linux
      Auto-update via Gear Lever
      Control desktop apps via MCP
    Tech Stack
      Electron
      AppImage
      GitHub Actions
      Rust MCP

Things people build with this

USE CASE 1

Install OpenAI Codex Desktop on a Linux machine without macOS

USE CASE 2

Get automatic updates of Codex through the AppImage update protocol

USE CASE 3

Let Codex inspect and control Linux desktop apps via the opt-in Computer Use plugin

Tech stack

ElectronAppImageGitHub ActionsRustMCP

Getting it running

Difficulty · easy Time to first run · 5min

x86_64 only and AppImage must be marked executable before first run.

In plain English

This repository is an unofficial Linux build of OpenAI Codex Desktop, packaged as an AppImage. OpenAI ships Codex Desktop only for macOS, so the author runs a daily GitHub Action that downloads the upstream Codex.dmg, patches the Electron resources inside it so they work on Linux, and publishes a fresh GitHub Release whenever OpenAI changes the app. It is a fork of ilysenko/codex-desktop-linux. The upstream project produces .deb.rpm, and Arch packages and uses a small on-device daemon to rebuild the app on each user's machine. This fork strips all of that out and ships a single artifact: one AppImage file that updates itself through the standard AppImage update protocol, with no daemon, no systemd unit, and no polkit prompts. To install, download the latest AppImage from the Releases page, mark it executable, and run it. The README recommends Gear Lever, a Flatpak app that integrates AppImages with the desktop and checks for updates automatically. The AppImage carries embedded update information that points back at this repo's releases, so Gear Lever and AppImageUpdate can pull new versions when they appear. Local builds are possible with a make build-app and make appimage command sequence on Debian or Ubuntu, but the author notes most users will not need to build it themselves. Only x86_64 is supported, because the upstream Codex.dmg is macOS x86_64 only and the extracted Electron files do not port cleanly to aarch64. The repository has 2 stars at the time of writing. There is also an opt-in plugin called Linux Computer Use, written and maintained by a contributor named avifenesh, which lets Codex inspect and control desktop apps on Linux through a Rust MCP backend. It supports listing apps via AT-SPI, taking screenshots through GNOME Shell or the XDG Desktop Portal, listing windows on GNOME, KDE, Hyprland, and i3, and sending keyboard and mouse input through ydotool. The README walks through the ydotool setup, portal backends for non-GNOME desktops, and how to enable the Computer Use controls in the Codex sidebar.

Copy-paste prompts

Prompt 1
Walk me through downloading the latest codex-desktop-appimage release and registering it with Gear Lever for automatic updates
Prompt 2
Show me the GitHub Action that patches Codex.dmg for Linux and explain each step
Prompt 3
Help me enable the Linux Computer Use plugin with ydotool on a non-GNOME desktop
Prompt 4
Diff this fork against ilysenko/codex-desktop-linux and explain what was stripped out
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.