Skip to content

Codex Deck v0.6.0

Choose a tag to compare

View all tags
@dazer1234 dazer1234 released this 18 Jul 06:06
· 32 commits to main since this release
v0.6.0
ab7b1a2
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.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.

Assets 6
Loading