@@ -16,6 +16,11 @@ Use this skill only from `/home/amwill/Applications/codex-app`.
1616- Refresh ` desktop/recovered/app-asar-extracted ` from the downloaded artifact's
1717 ` Contents/Resources/app.asar ` using ` --app-asar ` , or from a DMG using
1818 ` --dmg ` when the feed/source provides one.
19+ - Match the Linux ` codex ` helper to the CLI version bundled by that exact
20+ upstream desktop artifact. Replace ` desktop/resources/bin/linux-x64/codex `
21+ from OpenAI's matching ` @openai/codex@<version>-linux-x64 ` npm artifact and
22+ keep ` desktop/package.json ` ` codexCliVersion ` equal to the executable's
23+ reported version. Never update only the metadata or only the binary.
1924- Preserve Linux behavior patches in ` desktop/scripts/assemble-codex-runtime.mjs ` , especially:
2025 - Linux hidden titlebar/titlebar overlay path.
2126 - Linux native menu hide/remove behavior.
@@ -54,16 +59,29 @@ Use this skill only from `/home/amwill/Applications/codex-app`.
5459 and run ` desktop/scripts/refresh-recovered-from-dmg.mjs --app-asar <path-to-app.asar> --output ./recovered/app-asar-extracted ` from ` desktop ` .
5560 - For DMG artifacts, run ` desktop/scripts/refresh-recovered-from-dmg.mjs --dmg ../Codex.dmg --output ./recovered/app-asar-extracted ` from ` desktop ` .
5661 - Update ` desktop/package.json ` , ` desktop/package-lock.json ` , and tests that pin version/build metadata.
62+ - Determine the upstream bundled CLI version, fetch the exact official
63+ ` @openai/codex@<version>-linux-x64 ` npm artifact, replace
64+ ` desktop/resources/bin/linux-x64/codex ` , preserve executable mode, and
65+ confirm it prints ` codex-cli <version> ` .
66+ - Set ` desktop/package.json ` ` codexCliVersion ` to that verified version and
67+ refresh the lockfile. Do not infer the CLI version from the desktop app
68+ version.
5769 - If minified bundle shapes drift, add new patch alternatives without removing older supported shapes.
5870
59713 . Verify patch preservation:
6072 - ` node --check desktop/scripts/assemble-codex-runtime.mjs `
6173 - ` npm test -- --runInBand tests/linux/recovered-bundle.red.test.ts `
6274 - ` npm run test:linux `
6375 - ` npm run test:linux:codex-package `
76+ - ` desktop/resources/bin/linux-x64/codex --version ` must exactly match
77+ ` desktop/package.json ` ` codexCliVersion ` .
6478
65794 . Build and install:
6680 - Build with ` desktop/scripts/build-codex-linux-runtime.mjs ` into ` desktop/out/Codex-linux-x64-codex-<version>-<build> ` .
81+ - Run `desktop/scripts/verify-linux-package-contract.mjs --package-root
82+ desktop/out/Codex-linux-x64-codex-<version >-<build >` before installing;
83+ this must execute the packaged helper and validate the app-server protocol
84+ markers.
6785 - Copy that staged runtime to ` ~/.local/opt/codex-desktop/<version>-<build> ` .
6886 - Update ` ~/.local/opt/codex-desktop/current ` .
6987 - Validate desktop entries and refresh the desktop database.
0 commit comments