Codex UI Linux Port

Unofficial Linux packaging automation for Codex UI.

_{Made with 🖤 in Barcelona City 🇪🇸}

This repository rebuilds upstream Codex UI release artifacts into Linux packages for Codex UI through auditable scripts and GitHub Actions, with packaging targets for Arch, CachyOS, Debian, Ubuntu, and RPM-based distributions.

Project Signal

Area	Current signal
Release builder	GitHub Actions is authoritative
Source tracking	Upstream appcast, current source archive, SHA256 manifest
Linux targets	Arch/CachyOS, Debian/Ubuntu, Fedora/RHEL-like
Public status	Public automation repository
Data boundary	No chats, credentials, runtime state, private data, or local paths
AUR status	Metadata prepared, not published

What It Builds

• Arch/CachyOS package: .pkg.tar.zst
• Debian/Ubuntu package: .deb (experimental)
• Fedora/RHEL-like package: .rpm (experimental)
• Latest official macOS source asset: Codex-$VERSION.dmg
• Release manifest and checksums
• Future AUR metadata under packaging/aur

Why It Exists

Codex UI changes frequently. Linux users need a repeatable path that can:

• fetch the current upstream source archive
• rebuild native modules for Linux
• apply Linux desktop patches
• package the app for common Linux families
• verify artifacts before release
• keep private runtime data out of git

Operational Rationale

This project covers a practical need that emerged from daily engineering work: Codex UI is part of the maintainer's regular Linux workstation workflow, and frequent upstream updates made manual repackaging wasteful and error-prone.

The automation was built to turn unavoidable waiting periods such as long builds, dependency installs, and CI feedback loops into useful maintenance time. The goal is straightforward: keep the workstation reliable, reduce repeated manual update work, and improve day-to-day engineering throughput without storing private runtime data, credentials, chats, or local project material.

Install Or Update

codexui-update

Check without installing:

codexui-update --check

Run a smoke test:

codexui-update --smoke

Public release downloads do not require authentication. Private forks can use GITHUB_TOKEN or GH_TOKEN.

Release Pipeline

GitHub Actions is the authoritative builder.

Every scheduled or manual run reads the latest version from the official appcast, downloads the current official Codex.dmg, verifies its internal application version, computes its SHA256, compares it with the existing release manifest, and verifies every existing asset against checksums.txt. It rebuilds only when needed. If the same version tag exists but the source or any published artifact changed, release assets are refreshed with --clobber.

Required release assets:

• Codex-$VERSION.dmg
• codex-ui-linux-port-$VERSION-1-x86_64.pkg.tar.zst
• codex-ui-linux-port_$VERSION_amd64.deb
• codex-ui-linux-port-$VERSION-1.x86_64.rpm
• manifest.json
• checksums.txt

Local builds are supported for bootstrap and debugging:

scripts/build-from-dmg --source /path/to/Codex.dmg

Repository Boundary

Committed files must be limited to automation, patches, package metadata, and documentation. Upstream binaries, extracted app bundles, Codex chats, Codex profiles, runtime databases, local paths, tokens, and private keys must not be committed.

Before every commit and release:

scripts/privacy-audit

Public Status

• Repository visibility: public
• Release visibility: public
• AUR package: prepared, not published

Publication and redistribution notes live in docs/publication.md.

Documentation

• Usage
• Packaging
• Security And Privacy
• Changelog
• User Manual
• Architecture
• Roadmap
• Codex Instructions
• AUR Preparation
• Publication Checklist
• Security Policy
• Disclaimer

Documentación

• Uso
• Empaquetado
• Seguridad y privacidad
• Registro de cambios
• Manual de usuario
• Arquitectura
• Roadmap
• Instrucciones para Codex

Companion tools

• token-rat-esp: Spanish Codex skill for shorter answers, cleaner patches and token-efficient developer workflows.

License

Original automation scripts, Linux patches, packaging metadata, website material, and documentation in this repository are licensed under the PolyForm Noncommercial License 1.0.0.

This is a source-available, noncommercial license. It does not grant rights over Codex, Codex UI, OpenAI software, upstream binaries, application assets, release metadata, trademarks, or third-party dependencies. See NOTICE.md for the exact scope.

Disclaimer

This is an unofficial automation wrapper and packaging toolkit. Codex, Codex UI, OpenAI trademarks, upstream binaries, release metadata, and application assets belong to OpenAI or their respective owners. This repository is not affiliated with, endorsed by, or supported by OpenAI.