Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Codex SidekickNew to Visual Studio Code? Get it now.
Codex Sidekick

Codex Sidekick

Hower Chen

| (0) | Free
VS Code companion for Codex Sidekick on Stream Deck Neo. Open chats, follow activity, dictate drafts, and view usage. Requires the Stream Deck plugin. macOS only.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Codex Sidekick

Control the OpenAI Codex extension in VS Code from a Stream Deck Neo. Glowing chat keys, one-press dictation, and your Codex usage at a glance.

This is the VS Code companion for Codex Sidekick on Elgato Stream Deck Neo. Install both this extension and the Stream Deck plugin to use the hardware keys. This extension provides the local VS Code connection and Codex activity feed. The Stream Deck plugin displays the keys and Infobar and handles key presses.

Install the Stream Deck companion

Download the Codex Sidekick Stream Deck plugin from GitHub Releases. Download the .streamDeckPlugin file, double-click it, and confirm installation in the Stream Deck app. The prebuilt plugin requires an Apple silicon Mac.

The Elgato Marketplace listing is awaiting review. Use the GitHub download while that review is in progress, then follow the setup instructions below to connect both extensions.

Features

  • Recent chats, any project. Four keys show your latest local Codex chats across projects. Press a key to open that conversation in the Codex sidebar.
  • Activity colors. Blue while Codex has recently been working, amber after an approval request, green when a turn ends, and coral after an interruption. Colors are observations from hooks and fade as they expire.
  • One-press dictation. Press to record, press again to stop. Codex transcribes and leaves the draft unsent in the message box.
  • Codex shortcuts. Open the sidebar, start a new chat, or open a separate Codex editor panel.
  • Usage on the Neo Infobar. Remaining five-hour and weekly allowance, plus tokens from the latest reported request.

Requirements

  • macOS 13 or later. The prebuilt Stream Deck plugin currently requires Apple silicon; Intel users can build it from source.
  • Stream Deck Neo and Stream Deck 7.6 or later.
  • The companion Codex Sidekick Stream Deck plugin.
  • VS Code 1.96.2 or later with the official OpenAI Codex extension and a configured Codex account.
  • Node.js 22.18 or later for the activity hooks.
  • A trusted local folder in VS Code. Remote windows, virtual workspaces, and multi-root workspaces cannot connect to the deck.

Setup

  1. Install this extension and the companion Stream Deck plugin, then reload VS Code.
  2. Open one trusted local folder. Sidekick connects it and installs its activity hooks automatically. If setup needs attention, run Codex Sidekick: Set Up Chat Activity from the Command Palette.
  3. If you already have a ~/.codex/hooks.json file, review the draft Sidekick offers and merge its entries into that file. Sidekick never overwrites an existing hooks file.
  4. In the Codex sidebar, open Codex Settings → Hooks, review and trust the eight Sidekick hooks, then send a Codex message.
  5. In Stream Deck, put Chat Activity 1–4 on the top row; Open Codex, New Chat, New Panel, and Dictate below; and Codex Usage on the Infobar.
  6. For dictation, enable Elgato Stream Deck in System Settings → Privacy & Security → Accessibility. Allow VS Code to use the microphone when macOS asks.

Keep one VS Code window connected at a time. Use Codex Sidekick: Toggle Connection for This Workspace to connect or disconnect a folder. A second window does not connect automatically, and keys become unavailable if two windows are connected.

On the first chat-key press, confirm VS Code's prompt to open a link with OpenAI Codex and choose to remember your choice if desired.

Troubleshooting and limitations

Run Codex Sidekick: Show Diagnostics to see which Codex actions are available. The Codex Sidekick output channel contains diagnostic events.

Dictation uses a macOS Accessibility helper to find and click Codex's own microphone button. Codex handles the audio and transcription. The helper never reads chat text or text fields, and it refuses to act unless it identifies one Codex microphone. Changes to Codex's interface can require a Sidekick update.

Chat selection uses Codex's internal conversation route, which may also change. Activity colors describe recent observations rather than live state. Always check Codex itself for approvals and the current state. This is an early release tested on one Mac with one Neo.

Privacy and support

Sidekick runs locally and sends nothing over the network. Activity records contain event names, timestamps, hashed session and workspace identifiers, and token counts; they do not contain prompts, transcripts, or file paths. Chat titles and account usage are held in memory. Hooks apply to all local Codex sessions on the Mac, including the CLI and desktop app. Sidekick cannot approve, deny, or send anything.

Setup guide and source · Report an issue · Security and privacy

Codex Sidekick is an independent open-source project under the MIT license. It is not affiliated with, endorsed by, or sponsored by OpenAI, Microsoft, or Elgato. Product names are trademarks of their respective owners.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft