Setup
Deck Crew on Windows, from the Elgato Marketplace to your first chat on the keys. About ten minutes.
What you need
- Windows 10 or 11, a Stream Deck + and the Stream Deck app 7.1 or newer.
- At least one agent CLI: Claude Code, Codex, Antigravity CLI (agy), Grok Build or OpenCode. Each has its own deck; the All Agents Deck drives all five at once.
- On the All Agents Deck, chats from Qwen Code, Factory Droid and Cline show up too, with their live state. They have no deck of their own, and the deck never starts them for you.
1. Install the plugin
Get Deck Crew from the Elgato Marketplace: the All Agents Deck, or the single deck for the CLI you use. The Stream Deck app installs the plugin and adds its decks to your profile list. Pick a deck on your Stream Deck +.
2. Connect your agents
The deck learns what your chats are doing through small hooks in each agent CLI's settings. Two ways to add them:
- The Setup key. When it shows a HOOKS warning, press it: it adds the hooks for every agent CLI you have installed. Your own hooks and settings stay as they are, and each file is backed up first.
- The setup skill. Run
/deck-setupin Claude Code, agy, Grok or OpenCode, or$deck-setupin Codex. It checks the Stream Deck app and the plugin, offers the official installer for any CLI you're missing (it asks for each one), adds the hooks, connects your editors and walks you through a test of each deck.
3. Restart open chats
Agent CLIs read their hooks when a chat starts, so close and reopen any chat that was already running. In Codex, new hooks wait for your OK: type /hooks once and trust them. A new Codex chat shows on the deck after its first message.
4. Connect your editors (optional)
For chats in an editor's terminal or agent panel, the deck uses a small editor extension, the Deck Crew Bridge. Open the Setup key's settings in the Stream Deck app and go to Dev environments:
- Tick the editors to connect: Antigravity IDE, VS Code or Cursor.
- Review changes shows what will run and what gets backed up. Nothing is written yet.
- Connect installs the bridge. Then reload the editor window.
Terminals (Windows Terminal, WezTerm, Alacritty, Warp) need nothing and show as ready. If a connected editor's bridge goes missing or falls behind, the Setup key shows CONNECT; press it to reinstall.
5. Main (optional)
Main is the free Main Deck Crew profile for everything that isn't an agent: apps, audio, weather, timers. After installing it, run /main-setup ($main-setup in Codex). It checks which apps and gear you have, asks about your audio, knobs, weather town and End of day apps, shows the settings before saving them, and puts up the theme you pick.
If something's off
- Keys stay empty: look at the Setup key. A HOOKS warning means press it, then restart your chats.
- Free keys say "CLI missing": the deck can't find that agent's CLI on your PATH. Install it or fix your PATH; the keys catch up within ten minutes.
- A press flashes ⚠: the chat's window runs as administrator, and Windows blocks input to it from normal apps. Run the terminal or editor normally.
- The knobs show no data: the chat hasn't replied yet. Send it a message.
- Still stuck: write to us. Logs are in
%APPDATA%\Elgato\StreamDeck\Plugins\com.thedeckcrewhq.*\logs.
Uninstall
- Open the Setup key's settings and click Uninstall hooks, then click again to confirm. It removes only what Deck Crew added (hooks, status lines back to yours, its skills and editor bits) and leaves your own settings alone.
- Remove the plugin in the Stream Deck app.