// stream deck plugin for claude code

Every Claude Code session.
One key.

See who is working, who is waiting for you and who is done. Approve, answer, jump to the terminal and keep an eye on your plan — from the deck.

  • working
  • needs you
  • done
  • idle
Overview key Session working Session waiting Session done Session idle Named session Colored session Session with agents Context almost full Empty slot Empty slot Lockout clock Allow Deny Usage

STREAM DECK · live mockup, real key renders

A working day, at a glance

Colors tell the story before you read a word. Scroll on for the details.

Workingtool running · 2 agents · 31% context
Needs youpermission, question or plan
Donefinished, not yet looked at
Idlequiet since you last typed
/rename + /coloryour names, your colors
93% contextcompaction is near

// pro · approvals

Approve or deny without touching the keyboard

Keys stay dark until Claude asks. Then they light up with the tool and the command. One tap and Claude keeps going. No tap in 90 seconds, or the plugin is off? Claude shows its normal terminal prompt — nothing is ever blocked.

  • Allow once · Always allow (this session only) · Deny
  • Numbered keys mirror the terminal: 1 Yes · 2 Always · 3 No
  • Your settings files are never modified
Allow, idleAlways allow, idleDeny, idle Claude asks ↓ Allow, pendingPrompt textDeny, pending
Question Option 1Option 2Option 3

// pro · questions

Answer Claude's questions with one key

When Claude asks a multiple-choice question, the options become keys. The question key shows the text; press an option and the answer lands in the session. Several questions? They come one after another.

  • Works in every permission mode, including auto
  • Labels and descriptions straight from Claude
  • Multi-select questions stay in the terminal, and the key says so

// pro · session menu

Tap a session, get its menu

Short press opens a profile dedicated to that session: allow, deny, answer, focus its terminal, back. Long press brings the terminal to the front. Two ready-made profiles ship with the plugin for Stream Deck, Mini, XL, + and Neo — nothing to drag.

  • Overview key: totals, one tap to the sessions grid
  • Slot keys re-pack as sessions come and go; pin a project to a fixed key if you prefer
  • Focus follows the terminal app, whatever it is
Session menu profile on a Stream Deck
Anatomy of a session key

// pro · sessions

Finds every session, even the ones you forgot

Claude Code hooks report in real time, asynchronously, so Claude never waits on the deck. A process scan and Claude Code's own session registry pick up sessions started before install or idle for days. Background agents are counted; their work never hides a prompt waiting for you.

  • Names from /rename, colors from /color
  • Context-window bar per session, styled your way
  • Typed in that terminal? The key knows you saw it
Lockout clockForecast at resetBurn rate Usage sparklineWeekly peaksBudget

// pro · forecast & history

Know when you'll hit the wall, before you do

A small usage history kept on your machine turns today's numbers into a lockout clock, a projected percentage at the reset and a burn rate per hour. A sparkline shows the last hours; weekly peaks show the trend. Native alerts fire once per window: an early warning with the predicted lockout time, the hard threshold, and a ping when a nearly full window resets.

  • Your own budget: "80 % by the weekly reset", ahead or behind at a glance
  • Honest when unsure: needs two samples five minutes apart before any estimate
  • 24 h of samples, 14 days of hourly averages, 90 days of daily peaks: about 31 KB, deletable in one click

// lite & pro · plan usage

Your plan limits, five ways

The same numbers as /usage: 5-hour session, 7-day window and per-model, with time to reset as a countdown or a clock time. Pick the layout per key, including a credits view for extra-usage spend. Green, amber, red.

Usage key
Usage, high 7 day Per model

// two editions, one codebase

Start free. Go Pro when the sessions pile up.

ClauDeck Lite

Free

  • Plan usage keys, all five layouts
  • 5-hour, 7-day and per-model windows
  • Reset countdown, tap to refresh
  • Session keys
  • Approvals and answers
  • Session menu and profiles
  • Forecast, history and alerts
Get Lite on Marketplace

ClauDeck Pro

€3.99 one-time

  • Everything in Lite
  • One key per session: status, tool, agents, context, name, color
  • Approve / always-allow / deny from a key
  • Answer multiple-choice questions
  • Session menu, overview, bundled profiles for every deck
  • Focus the terminal, sound when Claude needs you
  • Forecast: lockout clock, reset projection, burn rate, budget
  • History: sparkline and weekly peaks
  • Native alerts, once per window, with your thresholds
Get Pro on Marketplace

Sold through the Elgato Marketplace. Requires the Claude Code CLI installed natively on macOS 12+ or Windows 10+ and a Claude subscription. Unofficial; not affiliated with Anthropic or Elgato.

// three steps

Installed in a minute

  1. 1

    Install from Marketplace

    Or double-click the .streamDeckPlugin from a release.

  2. 2

    Drag a key, press Install hooks

    In the key's settings. ClauDeck registers Claude Code hooks for you — async, never slowing Claude down.

  3. 3

    Restart open sessions once

    New sessions report on their own. Tap Overview to open the ready-made sessions profile.

// support

Something off? Tell us where.

Issues and discussions live on the public ClauDeckWeb repository. Include your OS, Stream Deck app version, Claude Code version and the plugin log. The log lives in the plugin folder under logs/; the debug trace of hooks can be switched on with touch ~/.claude/claude-deck/debug.

Which terminals work?

Any. The plugin identifies the terminal app from the session's environment (Ghostty, iTerm, Terminal, WezTerm, VS Code, Warp, cmux, Windows Terminal…). Focus brings the app to the front; the exact tab is yours to pick.

Does it slow Claude down?

No. Event hooks are asynchronous. The only synchronous hook is the permission prompt, and only in modes where Claude would ask you anyway. In auto mode it answers instantly and lets Claude's classifier decide.

What leaves my machine?

Nothing, except the call to Anthropic's usage endpoint made with the login token Claude Code already keeps (Keychain on macOS, credentials file on Windows). No analytics, no third-party servers.

WSL, SSH, containers?

Not supported: hooks run where Claude runs and cannot reach the plugin. Claude Code must be installed natively.

Can I keep my own layout?

Yes. Drag any ClauDeck key into any profile. The bundled profiles are a starting point, not a requirement.