Skip to content

Codex Deck v0.6.1

Choose a tag to compare

View all tags
@dazer1234 dazer1234 released this 18 Jul 17:45
· 24 commits to main since this release
v0.6.1
21371c4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 6
Loading