gitwtfhub

wtf is claude-deck?

alish3r/claude-deck — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A physical Stream Deck Plus controller that lets you turn knobs to switch the AI model or reasoning effort in Claude Code, and press to compact a chat.

Mindmap

mindmap
  root((claude-deck))
    What it does
      Model dial
      Effort dial
      Compact on press
      Verified writes
    Tech stack
      Node.js
      VS Code extension patch
      Elgato Stream Deck SDK
    Use cases
      Switch models fast
      Adjust reasoning effort
      Shrink long chats
    Audience
      Claude Code power users
      Stream Deck owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Switch the AI model for a specific chat tab by turning a physical dial instead of typing a command.

REASON 2

Adjust reasoning effort from low to max with a knob while coding.

REASON 3

Compact a long conversation by pressing a dial instead of typing slash compact.

REASON 4

Run the compact shortcut from a plain terminal session without the VS Code extension.

What's in the stack?

JavaScriptNode.jsVS Code Extension APIElgato Stream Deck SDK

How it stacks up

alish3r/claude-deck0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an Elgato Stream Deck Plus, its companion app, Node 20+, and currently runs on Windows only.

The README does not state license terms.

Wtf does this do

Claude Deck turns a physical Elgato Stream Deck Plus into a set of knobs for the Claude Code coding assistant inside VS Code. The Stream Deck Plus is a specific piece of hardware with four rotary dials and a small touch screen strip above them. This project only works with that model, not the button only Stream Decks. Two dials matter here. One dial controls which AI model the current chat tab is using, so turning the knob switches models for whatever conversation you have open. The other dial controls reasoning effort, moving through levels from low up to max. Pressing either dial sends the compact command, which shrinks a long conversation down. Small screens on the dials show the current model and effort level so you always know what is active. The model dial follows whichever chat tab you are actually looking at, and switches its display when you change tabs. The effort setting is shared across all chats rather than per conversation, and the tool is upfront about that limitation on its display. Every change the dial makes is checked by reading the actual saved value back from disk afterward, rather than trusting a success signal that might not reflect what really happened. Beyond VS Code, there is also a separate terminal launcher that lets the compact command work in a plain terminal window running the Claude command line tool, without needing the patched editor extension at all. This project is unofficial and not affiliated with Anthropic or Elgato. It works by applying a local, reversible patch to the already installed Claude Code extension on your own machine, since there is no official way to control these settings. That patch can break whenever the extension updates and needs to be reapplied by hand. It requires Node version 20 or higher and currently runs on Windows, with Mac support still experimental and Linux untested.

Yoink these prompts

Prompt 1
Walk me through installing the Claude Deck plugin on my Stream Deck Plus and pairing it with VS Code.
Prompt 2
Explain how the model dial in claude-deck decides which chat tab it is controlling.
Prompt 3
Show me how to reapply the claude-deck patch after a Claude Code extension update breaks it.
Prompt 4
Help me set up the standalone terminal launcher from claude-deck so compact works outside VS Code.

Frequently asked questions

wtf is claude-deck?

A physical Stream Deck Plus controller that lets you turn knobs to switch the AI model or reasoning effort in Claude Code, and press to compact a chat.

What language is claude-deck written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, VS Code Extension API.

What license does claude-deck use?

The README does not state license terms.

How hard is claude-deck to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-deck for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.