Codex Deck v0.7.0.2

Codex Deck v0.7.0.2

This focused stability hotfix improves single-computer and mixed Mac/Windows
operation. It does not include the in-development task timer or StandBy
dashboard work.

Fixes

• Normalizes remote timestamps when a snapshot arrives, preventing normal clock
  differences between Mac and Windows from hiding working, selected, approval,
  context, or usage state.
• Returns controls to the local computer when a previously configured second
  host has been removed. A configured but temporarily offline relay still keeps
  the user's explicit remote selection.
• Keeps unique last-known tasks visible on iPhone when one computer disconnects,
  marks them offline in the app and widgets, and blocks taps that cannot be
  delivered.
• Routes iPhone commands through the healthy connection when duplicate profiles
  authenticate as the same computer.

Downloads

• Stream Deck: com.simeo.codex-deck.streamDeckPlugin
• Windows launcher: codex-deck-launcher-windows-v0.7.0.2.zip
• macOS launcher: codex-deck-launcher-macos-v0.7.0.2.zip
• iPhone source: use the Source code archive or clone tag v0.7.0.2.
• Checksums: SHA256SUMS.txt

Existing v0.7.0 and v0.7.0.1 launcher/watcher installations remain compatible.
Stream Deck users only need to install the updated plugin. Codex itself does not
need to restart.

Codex Deck is an independent community project and is not made, supported, or
endorsed by OpenAI or Elgato.

Codex Deck v0.7.0.1

Codex Deck v0.7.0.1

This hotfix hardens mirrored task identity between Windows and macOS Codex
instances. It does not change the launcher, watcher, iPhone pairing, or native
Codex Micro command surface introduced in v0.7.0.

Fixes

• De-duplicates a new task while Codex transitions from its temporary renderer
  ID to the stable rollout ID visible on the other host.
• Remembers that mapping across later task selections and relay reconnects in
  both Windows-to-Mac and Mac-to-Windows directions.
• Uses the title and context usage available from either mirror when one host
  temporarily publishes incomplete metadata.
• Shows New chat for an assigned titleless thread and reserves Not assigned
  for a genuinely empty agent slot.
• Keeps a neutral context ring visible until the first token-count event arrives.

Downloads

• Stream Deck: com.simeo.codex-deck.streamDeckPlugin
• Windows launcher: codex-deck-launcher-windows-v0.7.0.1.zip
• macOS launcher: codex-deck-launcher-macos-v0.7.0.1.zip
• iPhone source: use the Source code archive or clone tag v0.7.0.1.
• Checksums: SHA256SUMS.txt

Existing v0.7.0 launcher and watcher installations remain compatible. Stream
Deck users only need to install the updated plugin. Reload the Codex Deck
Stream Deck plugin after updating; Codex itself does not need to restart.

Codex Deck is an independent community project and is not made, supported, or
endorsed by OpenAI or Elgato.

Codex Deck v0.7.0

Codex Deck v0.7.0

This release adds Codex Deck Mobile for iPhone while preserving the established
Windows, macOS, and Windows-plus-Mac Stream Deck paths.

Highlights

• Native SwiftUI iPhone companion for Mac and Windows Codex nodes.
• Six merged agent slots, native Micro controls, usage windows, reset credits,
  task details, command receipts, notifications, Live Activity, and widgets.
• Pinned-TLS Nearby pairing for normal private Wi-Fi without an account.
• Optional private remote access through Tailscale; Chrome DevTools always
  remains loopback-only.
• Polished adaptive iPhone icon for light, dark, and tinted Home Screen modes.
• Usage Limit, two-window Usage Overview, and hold-to-confirm Rate Limit Reset
  Stream Deck actions.
• Compatibility fixes for current Codex desktop builds, active/completed task
  state, empty agent artwork, adaptive landscape layout, and live relay version
  metadata after updates.

Choose the correct download

• Everyone using Stream Deck installs com.simeo.codex-deck.streamDeckPlugin.
• Windows launcher: codex-deck-launcher-windows-v0.7.0.zip.
• macOS launcher: codex-deck-launcher-macos-v0.7.0.zip.
• iPhone app: download this release's Source code (zip) or clone the
  v0.7.0 tag; there is no App Store, TestFlight, or pre-signed iPhone binary.
• Verify downloads against SHA256SUMS.txt.

Installation

• Windows
• macOS
• Windows and Mac together
• iPhone source installation
• iPhone local Wi-Fi test without Tailscale

Important

The iPhone app currently requires a Mac with Xcode to build, sign, and install,
even when it will control only Windows. After installation, that Mac does not
need to stay online unless it is itself one of the controlled nodes.

Existing Stream Deck layouts and desktop-only installations remain supported.
For plugin updates, reload the Codex Deck Stream Deck plugin; do not restart
Codex merely to update the plugin.

Foreground task status is snapshot-driven. A newly started or completed task
normally appears on the phone within about one to three seconds; truly
event-driven instant delivery is planned separately rather than increasing CDP
polling load in this release.

Validation boundary

The release candidate is checked with TypeScript, the complete Node test suite,
Stream Deck validation/packing, release privacy audit, shell syntax and plist
validation, macOS watcher self-test, generic iOS build, physical-iPhone Swift
tests, and the real Windows/Mac bridge setup. No official OpenAI keycap SVG,
private relay token, signing identifier, personal path, or runtime state is
included in the public artifacts.

Acknowledgement

The idea to explore a phone-native Codex Micro companion was inspired in part
by the public mobile concept shared by Shikhar (@xikhar).
Codex Deck Mobile is an independent implementation and includes none of that
concept's source code or artwork.

Codex Deck is an independent community project and is not made, supported, or
endorsed by OpenAI or Elgato.

Codex Deck v0.6.3

Codex Deck v0.6.3 fixes delayed and stuck completion states in single- and multi-host setups.

What changed

• Completed tasks no longer remain stuck in the green finished state after they are opened.
• Completion acknowledgement uses the structural task_complete revision instead of rollout modification time, so harmless file touches cannot resurrect an old completion.
• Codex Deck now detects the task currently open in each Codex renderer even when that task is outside the host's six native Micro slots.
• Active-task and completion-revision signals remain content-free and travel through the existing authenticated relay, allowing mirrored tasks opened on either computer to clear correctly.
• A task that was already open while it ran still shows its new finished state; a later activation or Stream Deck press acknowledges it.
• Delayed completion metadata can no longer override a newer native working/thinking state.

Updating

1. Install com.simeo.codex-deck.streamDeckPlugin on the computer running Stream Deck.
2. Windows-only: reinstall the Windows launcher if you use its persistent watcher.
3. Mac-only: reinstall the macOS launcher alongside the plugin.
4. Windows + Mac: reinstall both launcher archives so both relay endpoints understand the new content-free state fields.
5. Restart only the Stream Deck plugin/app after updating. A manual Codex restart is not required.

Downloads

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

Validation

• TypeScript check and all 79 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.
• The build was loaded on the real 15-key Stream Deck MK.2 and live Windows/macOS relay without restarting either Codex app.
• Live renderer inspection confirmed that a Windows task outside the six native Windows Micro slots is still reported as the active Windows task, independently of the active Mac task.

SHA-256

• macOS launcher: eecea4faad2987f55e45e098a2501da93bcab8500bd3c04004f245bdd938d2b1
• Windows launcher: 489bac2d5dd37a68753d595ed8970b677e61f18a63514453c9c96a2cddc6081a
• Stream Deck plugin: 4b3e0e7c04de05632f0269dff578b9c205d8cbf8c3548c82e5e5526cae1003f4

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.

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.

Codex Deck v0.6.1

Codex Deck v0.6.1 is a reliability and multi-host behavior release for the unofficial Codex Micro-style Stream Deck integration.

Highlights

• Supports all four native Codex Micro agent sources across Windows and Mac: Pinned, Recently updated, Priority, and Individual assignments.
• Interleaves combined pinned tasks fairly, preserves controller-side Individual assignments, fills empty slots from the other host, removes mirrored duplicates, and routes every agent key to the computer that owns the task.
• Uses a content-free local session-presence catalog to keep cloud and remote-SSH mirrors attached to their real Windows or Mac owner even when that task is outside the owner's six visible native slots.
• Fixes stale or stuck agent states after Codex updates, including additional native thinking/completion names and short-lived completed owner sessions.
• Fixes intermittent remote agent presses caused by renderer evaluation promises being collected too early.
• Follows the main Codex renderer after macOS app updates instead of attaching to auxiliary avatar surfaces.

macOS restart-loop safety

This release fixes a real restart loop observed after a Mac lost power while the Windows relay was connected. An early relay snapshot could reject before the native Micro signals were ready, terminate the watcher, and let LaunchAgent repeat the cycle.

• Authenticated relay snapshot failures are now contained and rate-limited.
• The watcher never launches Codex while the app is closed.
• An unbridged process must remain stable before one guarded recovery restart is allowed.
• A generation-independent ten-minute circuit breaker prevents PID-to-PID recovery loops.
• LaunchAgent stderr is retained in ~/Library/Application Support/CodexDeck/watcher.stderr.log.

Updating

1. Install com.simeo.codex-deck.streamDeckPlugin on the computer running Stream Deck.
2. Windows: extract codex-deck-launcher-windows-v0.6.1.zip and run Start-CodexDeck.ps1 -InstallStartup again.
3. macOS: extract codex-deck-launcher-macos-v0.6.1.zip and run ./start-codex-deck.sh install again.
4. Restart only the Stream Deck app/plugin after updating. Do not manually restart Codex for the plugin update.

For Windows-only or Mac-only use, install only that platform's launcher. The authenticated relay is optional and only needed when one Stream Deck controls both computers.

Downloads

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

Validation

• TypeScript check passed.
• 73 automated tests passed locally.
• Elgato Stream Deck package validation passed.
• Release audit passed against the source roots and the three freshly extracted release artifacts.
• npm ci on macOS reported zero vulnerabilities.
• macOS launcher scripts were verified as executable (0755) inside the ZIP.
• The real Windows-to-Mac SSH relay, native Micro event bus, guarded one-time recovery, and stable post-recovery watcher/Codex PIDs were verified on the live setup.
• GitHub CI remains to be run after the release branch is pushed.

SHA-256

• macOS launcher: 79643ad5088a129a4e84439cb204e9af22ab9e474f73a80a36506fba0c74e78b
• Windows launcher: 959987f697a10d679098d674ffd0cef1633eab45e8d002ea2e33a5268fd067e7
• Stream Deck plugin: 81b83dd84995238acb94532f9efdbf2c098ccb7d470195b2f067a9d9b207ecd7

OpenAI's protected Codex Micro keycap SVG contents are intentionally not included. Codex Deck includes its own 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.

Codex Deck v0.6.0

Codex Deck v0.6.0 expands the unofficial Codex Micro-style Stream Deck integration from Windows into a reliable Windows, macOS, or optional dual-computer setup.

Highlights

• Adds a native macOS launcher and persistent LaunchAgent watcher.
• Replaces the Windows one-shot startup launcher with a durable single-instance watcher that recovers after normal Codex restarts, crashes, and updates.
• Supports three independent setups: Windows only, macOS only, or Windows and Mac together.
• Adds an opt-in authenticated SSH/Tailscale relay for mixed global agent slots and native command routing across both computers.
• Keeps each agent key bound to the computer that owns the task while globally ordering the six most recently active tasks.
• Adds a Windows/Mac control-target action, host badges, stable task ownership, and protection against remote-SSH mirror duplicates.
• Preserves all native Micro action, joystick, encoder, reasoning, approval, microphone, and live agent-state behavior.
• Adds separate launcher packages, checksums, and an automated release audit that excludes private state, personal setup markers, and protected keycap SVG contents.

The documented 15-key layout is only a recommended starting point. Every action, position, page, and profile can be customized freely.

Downloads

• com.simeo.codex-deck.streamDeckPlugin — install or update the Stream Deck plugin on the computer running the Stream Deck software.
• codex-deck-launcher-windows-v0.6.0.zip — Windows-only launcher and watcher.
• codex-deck-launcher-macos-v0.6.0.zip — macOS-only launcher and watcher.
• SHA256SUMS.txt — checksums for all three install artifacts.

For a single computer, install only that platform's launcher. For a Windows + Mac setup, install both launchers and follow docs/MULTI_HOST.md; the Stream Deck software itself only needs to run on the computer physically connected to the Stream Deck.

Node.js 20 or newer is required. Start with the platform guide in docs/WINDOWS.md or docs/MACOS.md.

Local keycap artwork

OpenAI's protected Codex Micro SVG contents are intentionally not distributed. Codex Deck includes its own publishable agent and navigation artwork and can load official keycap SVG files supplied locally by the user. See docs/ICON_SETUP.md.

Validation

• TypeScript check passed
• 55 automated tests passed locally
• GitHub CI passed
• Elgato Stream Deck package validation passed
• release audit passed for all three artifact roots
• macOS executable permissions verified in the release ZIP

SHA-256

• macOS launcher: 5763c6de7484d135bfbe0bb22785f8cd8ee963e652bf3213854bb190907c73dc
• Windows launcher: fc114ba42f7cdf32b189f21a08a9450d56145ce877e4fb3c8858bf7fbecde418
• Stream Deck plugin: f21aa809cb118c0bddfcd1d435ec63e49b165cf769a6fd787392275515d00ea3

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

Codex Deck v0.5.0

Codex Deck v0.5.0 expands the Stream Deck integration from the primary Codex Micro layout into a complete, faster command surface.

Highlights

• Adds standalone Stream Deck actions for all 30 official Codex Micro keycaps, including the native press/release microphone action.
• Resolves keycap behavior from the live registry in the installed Codex build instead of maintaining fragile hardcoded command IDs.
• Adds full Codex-aligned light and dark rendering, polished agent-state glows, restrained active-state animation, and readable fallbacks when a local SVG is unavailable.
• Keeps current Codex awaiting-approval and awaiting-response states orange until the user responds.
• Prevents overlapping bridge polls, redundant image transfers, and idle animations to reduce Stream Deck traffic and improve responsiveness.
• Supports multiple copies of the same action across pages and profiles.
• Updates the renderer bridge for Codex for Windows 26.715.2305.0.
• Reuses an already healthy Codex Deck debug session instead of restarting Codex on every launcher run. A clean restart remains available explicitly with -ForceRestart.
• Adds optional Windows-startup installation through Start-CodexDeck.ps1 -InstallStartup.

Downloads

• com.simeo.codex-deck.streamDeckPlugin — install or update the Stream Deck plugin by double-clicking it.
• codex-deck-launcher-v0.5.0.zip — extract the complete folder, then run Start Codex Deck.cmd.

The launcher folder must stay intact. Node.js 20 or newer is required.

Local keycap artwork

OpenAI's Codex Micro SVG assets are intentionally not included. Codex Deck can load files you provide locally from %LOCALAPPDATA%\CodexDeck\icons; otherwise every action receives a readable built-in fallback. See docs/ICON_SETUP.md for the local-only setup workflow.

Verified environment

• Codex for Windows 26.715.2305.0
• Stream Deck 7.4.2.22730
• Windows 10.0.26220.0
• Node.js 24.13.0
• Standard 15-key Stream Deck MK.2

Validation passed with TypeScript checking, 19 automated tests, Elgato package validation, a 30-icon local QA pass, launcher dry-run, and clean extraction of both release downloads.

SHA-256

• Plugin: 82fa3088fae0b7949d21b0ed953fb0335c01dc031dd6e5ebf42f0872905a45de
• Launcher: bc1ac955ade0817fd78545676fba33401083f69c14886c094e5f3885ab9e4ab3

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

Codex Deck v0.4.1

Initial public release of Codex Deck.

Highlights:

• Six dynamic Codex Micro agent slots with live status colors and animation
• Native Micro action, joystick, encoder, and reasoning-effort controls
• Loopback-only Windows launcher; no global hotkeys or task-database/log fallback
• Optional local keycap SVG loading without redistributing OpenAI asset files
• Tested with Codex 26.707.12708.0, Stream Deck 7.4.2.22730, and a 15-key Stream Deck MK.2

Important: this is an unofficial community project that relies on undocumented Codex desktop internals. Read the installation and security sections before use.