Install
Install and activate VibeDeck
You need a compatible Stream Deck device with Stream Deck 7.1+, plus an Apple Silicon Mac (M1 or newer) with macOS 13+, or a Windows 10+ PC. Your license email contains the installer download link and license key.
Watch the setup
Install from the Elgato Marketplace
Read the steps
- In the Stream Deck app, open Marketplace and search for VibeDeck.
- Install the VibeDeck plugin.
- Drag VibeDeck → Setup from the action list onto any key.
- The Setup panel opens. “Ready at a glance” shows what is left to do.
- Click “Continue setup ↗”. The Setup page opens in your browser.
- The Setup page starts with your agents. Pick the ones you use.
- Next: connect Claude Code. The “Connect Claude Code” video shows each step.
Install from getvibedeck.com
Read the steps
- Go to getvibedeck.com/trial and enter your email.
- Click “Email me a confirmation link”.
- “Check your inbox.” Open the link within one hour to start the trial.
- Your key and installer links arrive by email. Buyers get the same in the purchase email.
- Double-click vibedeck-mac.streamDeckPlugin. Stream Deck installs it.
- Windows: vibedeck-win.streamDeckPlugin. If SmartScreen warns, click “More info”, then “Run anyway”.
- Drag VibeDeck → Setup from the action list onto any key.
- The Setup panel opens. Click “Continue setup ↗”.
- Paste the key from your email into “License key”.
- Click “Activate license”.
- The top bar now says “Licensed” with the last four characters of your key.
Connect Claude Code
Read the steps
- In Setup, under “Connect the agents you use”, select Claude Code.
- Click “Preview affected files” to see what will change.
- Then click “Install hooks”.
- Hooks installed. Setup moves on by itself.
- “Your hooks are ready.” Next: add All Sessions to a key.
- In the Stream Deck app, drag VibeDeck → All Sessions onto a free key.
- With no agent running, the key reads “no session”.
- Start a fresh Claude Code session and send one prompt.
- The key lights up with that session.
- Select the Setup key. Under “Screen and deck”, find “Answer profile”.
- Click “Install Answer profile”. If Stream Deck asks to install it, accept.
- When Claude asks, a card shows on screen and the deck switches to Answer.
- Tap Allow, Always or Deny on the deck.
- The agent carries on.
macOS
Download the plugin
Get
vibedeck-mac.streamDeckPluginfrom the download link in your license email.Double-click to install
Stream Deck installs it automatically. VibeDeck is notarized, so Gatekeeper normally won't prompt. If it does, right-click the file and choose Open, then confirm.
Windows
Download the plugin
Get
vibedeck-win.streamDeckPluginfrom the download link in your license email.Double-click to install
Stream Deck installs it automatically. SmartScreen may flag it as unrecognized — click More info, then Run anyway.
Activate and connect your agents
Drag the Setup key
Drag VibeDeck's Setup action onto any free key. Its setup page opens in your browser.
Paste your key and Activate
Paste your license key on the setup page and press Activate. Every VibeDeck key unlocks live — no restart needed.
Select and preview agents
Choose only the detected agents you use, then preview every configuration file VibeDeck will extend. Nothing is selected by default. Existing hook arrays are preserved, conflicts are skipped, and a backup is created before changes.
Install the hooks
Confirm the preview. VibeDeck merges its entries, validates the result, and rolls back if validation fails. Some integrations may report a limited or needs-review state instead of a clean install; review that message before continuing.
Restart and verify
Restart each affected agent session and send one prompt. A live session card on your deck confirms the connection. If a key stays idle, check the Setup page for updates, limited states, or a needs-review message.
Choose a session view
DeepSeek Harness does not have a dedicated Session key. Add the All Sessions or Swarm action to see it alongside your other agents.
Switching machines? Deactivate this one from the setup page first. If the old machine is gone, use verified activation support.
Status-only integrations
These integrations report status without deck control. Gemini CLI, Kilo, and Qwen Code each have their own Session key and also appear on All Sessions and Swarm, with no typing, dictation, interruption, deck approval, model, or effort control. DeepSeek Harness has no dedicated Session key. Answer questions and approvals in the agent.
- DeepSeek Harness: macOS with dsh web or headless. Approvals and questions stay in the dsh web UI. The optional navigation companion is not installed by normal Setup.
- Gemini CLI: native hooks. Cancellations and errors are not fully observable, and macOS and Windows verification is still pending.
- Kilo: CLI or VS Code plugin. Activation in the real runtime is pending, and there is no reliable settled-success done state.
- Qwen Code: supported hook mode. Main sessions only; subagents are excluded.
Updates after installation
VibeDeck checks its signed update service for newer releases. Update manifests and payloads are signature- and hash-verified before installation.