Codex Deck v0.6.2

Codex Deck v0.6.2 makes host failures explicit instead of letting last-known Codex Micro state look live, and restores compatibility with the current Codex desktop Micro internals.

What changed

• The existing Windows / Mac Target action is now Windows / Mac Target + Health and shows the selected host as READY, DEGRADED, CONNECT, or OFFLINE.
• Authenticated relays emit typed degraded-health events when native Codex renderer signals are unavailable.
• Remote snapshots older than five seconds become degraded using local receipt time, so clock differences cannot hide stale state.
• Last-known agent tasks keep their slots during a host failure. Affected tiles show orange for uncertain native state and red when their host is offline.
• Commands still require their authenticated owning host and never fall through to the other computer.
• Reasoning up/down now uses Codex's native Micro encoder-rotation HID events.
• Standalone official keycap actions dynamically resolve the command runner used by the currently loaded Codex Micro bridge, with a fallback for older Codex builds.
• Relay health-only changes no longer break snapshot-only clients or the relay smoke test.

The host-wide failure does not consume one of the six agent keys. The target key is the health surface; warnings on affected agent tiles identify stale tasks.

Updating

1. Install com.simeo.codex-deck.streamDeckPlugin on the computer running Stream Deck.
2. Windows-only: reinstall the Windows launcher if you want the updated persistent watcher files.
3. Mac-only: reinstall the macOS launcher alongside the plugin.
4. Windows + Mac: reinstall both launcher archives so both sides use the current compatibility fixes.
5. Restart only the Stream Deck plugin/app after updating. A manual Codex restart is not required for the plugin update.

Downloads

• com.simeo.codex-deck.streamDeckPlugin — Stream Deck plugin v0.6.2.0.
• codex-deck-launcher-windows-v0.6.2.zip — Windows launcher and persistent watcher.
• codex-deck-launcher-macos-v0.6.2.zip — macOS launcher and persistent LaunchAgent watcher.
• SHA256SUMS.txt — SHA-256 checksums for all three installation artifacts.

Validation

• TypeScript check and all 76 automated tests passed.
• Elgato validation passed for the build and the plugin extracted from the exact release artifact.
• The exact Windows ZIP passed its nine-case watcher self-test and read-only dry run.
• The exact macOS ZIP passed its recovery/circuit-breaker self-test and read-only dry run on macOS; both launchers retained executable 0755 permissions.
• All three extracted artifacts passed the private-state and protected-SVG release audit.
• Plugin v0.6.2.0 was loaded on the real 15-key Stream Deck MK.2 without restarting Codex.
• A live authenticated Windows-to-Mac test passed relay snapshot delivery, native action press/release, joystick movement, reasoning decrease/increase, encoder press/release, and agent routing.
• The current official standalone command runner and FAST keycap command were resolved live. Codex correctly reported FAST unavailable in the Mac renderer's current composer context, so a visual FAST-mode change is intentionally not claimed as an automated pass.
• Real watcher reloads and prior runtime logs exercised OFFLINE → READY and stale DEGRADED → READY recovery without restarting Codex.

SHA-256

• macOS launcher: 75cfa45981b3c43982604e44c90b73ae9e85095e2d9786e0be597a5abd96a5b6
• Windows launcher: 12395686cb92f18303e5312d46d3195278e5eaa10eea41e6067bd1ea8992a1d4
• Stream Deck plugin: 87c331805a116929ae3a33775b0237f1e9b0ffb2a7be171504ba96ed2fba9e94

OpenAI's protected Codex Micro keycap SVG contents are intentionally not included. Codex Deck includes publishable agent/status artwork and can load user-supplied local keycap SVG files. See docs/ICON_SETUP.md.

Codex Deck is an independent community project. It is not made, supported, or endorsed by OpenAI or Elgato and relies on undocumented Codex desktop internals that may change.