gxanshu/codex-desktop-appimage

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.