skills.rest
am-will
am-willCOMMUNITY
Explore all skills by this author →
GitHub

update-codex

Updates a Linux port of the Codex desktop app from upstream Mac artifacts while preserving Linux patches.

1.0k|58|Updated Jan 16, 2026
Search Tags:#desktop app#release automation#electron#Linux#patching#CODEX#app.asar
One-click install
npx skills add https://github.com/am-will/codex-skills --skill update-codex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-codex
Source: https://github.com/am-will/codex-skills/tree/main/skills/update-codex
Command: npx skills add https://github.com/am-will/codex-skills --skill update-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintaining a Linux port of the Codex desktop app requires repeatedly downloading upstream Mac releases, re-extracting the app bundle, and reapplying Linux-specific patches without regressions. This Skill codifies that entire update, verification, install, and release workflow so nothing is missed.

Core Features & Use Cases

  • Upstream Artifact Fetching: Downloads the newest release from the official appcast feed, supporting both versioned zip artifacts and DMG files, and verifies version/build metadata.
  • Patch Preservation: Refreshes the recovered app.asar bundle while preserving Linux-specific patches such as hidden titlebar, native menu removal, external browser routing, and pet/avatar overlay behavior under X11/XWayland.
  • Build, Install, and Release: Builds the Linux runtime, installs it to a versioned directory with a current symlink, and optionally commits, tags, and publishes AppImage, deb, and rpm release artifacts via a tag-driven workflow.
  • Use Case: When a new Codex Mac release ships, run this Skill to port it to Linux, verify the X11 launch contract and pet overlay behavior, and ship the tagged Linux release.

Quick Start

Update the codex-app Linux port to the latest upstream Codex release, preserving all Linux patches, then install and verify the refreshed desktop app.

Frequently Asked Questions about update-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a Linux port of an Electron app from a Mac release?▼

Download the newest artifact from the app's appcast feed, extract Contents/Resources/app.asar, and refresh the recovered bundle with a refresh script. Then reapply platform patches, rebuild the runtime, and install it to a versioned directory with a current symlink.

How do I extract app.asar from a Codex Mac zip or DMG artifact?▼

For zip artifacts, extract Codex.app/Contents/Resources/app.asar and run refresh-recovered-from-dmg.mjs with the --app-asar flag. For DMG artifacts, pass the DMG path with the --dmg flag to the same script.

Why does the Codex Linux pet overlay lose keyboard focus or fail to drag?▼

The pet window must stay focusable and the top-enforcement timer must not call showInactive() while focused, or the reply input loses keystrokes. Drag must start only from the avatar mascot target, and pointer passthrough must be disabled on the X11 path.

Does the Codex Linux port support Wayland sessions?▼

The port targets GNOME Wayland sessions but forces X11 via ELECTRON_OZONE_PLATFORM_HINT=x11 and --ozone-platform=x11 in desktop entries and packaged launchers. This X11 contract is required for reliable pet dragging and always-on-top behavior.

How are Linux release artifacts published for the Codex port?▼

Commit with a Conventional Commit, push main, then create and push an annotated v<version> tag. The tag-driven GitHub workflow publishes AppImage, deb, and rpm assets; there is currently no Arch package lane.

Related Skills

Explore More Software Engineering Skills→
rieaseriease

setup-vue-backend

Set up Vue 3 projects with AutoRisk-365 compliant dependencies, scripts, and Vite aliases.

Official
Intermediate
FlukeSupakornFlukeSupakorn
1

packaging-tauri-for-linux

Package Tauri v2 apps for Linux into AppImage, Debian, RPM, Flatpak, Snap, and AUR formats.

Community
Advanced
multiversxmultiversx
12

fix_verification

Verify smart contract bug fixes by running Mandos scenarios and regression tests.

Official
Intermediate
SocketDevSocketDev
3

regenerating-node-patches

Regenerates Node.js v25.5.0 SHA-3 patches with validation and backups.

Official
Advanced