Codex App Packaging for Arch Linux

This repository provides an Arch Linux package build for Codex Desktop (x86_64) from the macOS DMG source.

Scope

• Target distro: Arch Linux
• Target architecture: x86_64
• Package format: pacman package (.pkg.tar.zst)

Prerequisites

Install base packaging tools:

sudo pacman -S --needed base-devel git

makepkg -s installs package dependencies declared in PKGBUILD automatically.

Network access is required to download:

• Codex.dmg
• npm tarballs for native modules resolved dynamically from the app bundle

Build Workflow

From repository root:

makepkg -si

Run

codex-app

Run Release Executable

Releases include a portable executable bundle for Linux:

• codex-app-linux-x86_64.tar.gz
• codex-app-linux-x86_64.tar.gz.sha256

Verify and run:

sha256sum -c codex-app-linux-x86_64.tar.gz.sha256
tar -xzf codex-app-linux-x86_64.tar.gz
chmod +x codex-app-linux-x86_64/codex-app
./codex-app-linux-x86_64/codex-app

Output Layout

• Build workspace: src/, pkg/
• Built package: *.pkg.tar.zst (repo root)

Update Process

When updating package inputs:

1. Update pkgver, source URLs/versions, and checksums in PKGBUILD when needed.
2. Regenerate checksums if needed:

updpkgsums

3. Regenerate .SRCINFO:

makepkg --printsrcinfo > .SRCINFO

4. Rebuild:

makepkg -f

Checksum Policy

Codex.dmg is served from a rolling CDN URL and may change without notice. The nightly release workflow tracks the upstream Codex app version in .codex-version and persists the latest DMG SHA-256 in .codex-dmg.sha256. A new release is published only when the extracted upstream app version changes, not on every DMG repack with identical app contents. When the DMG is repacked without a version change, the workflow refreshes checksums only and skips the version bump, rebuild, and GitHub release publication.