@pimmesz/jetstream

Full Claude control on your Elgato Stream Deck.

One key per project, glowing with that project's live Claude Code status — working, needs-you, done, failed — plus an attention doorbell, usage gauges, and deck approvals. Add app / URL / command shortcut keys, give any key a colour, emoji, or the app's real logo, and build your whole board by talking to it (jetstream chat).

This package is the installer: it ships the packed Stream Deck plugin and hands it to the Stream Deck app for you.

Install (macOS)

npm i -g @pimmesz/jetstream
jetstream install

Approve the install prompt in Stream Deck. Then set up your fleet:

jetstream chat   # conversational — "3 repos in ~/dev: …", "add a Telegram key at a8"
jetstream init   # guided wizard — repos, theme/timings, a ready-made layout

Updating? jetstream update — fetches the latest published package from npmjs.org and reinstalls the plugin in one step, so a bare npm i -g behind a stale mirror can't strand you on an old version (override the registry with JETSTREAM_REGISTRY).

Requires macOS 12+ and the Stream Deck app 7.1+. You also need Claude Code, logged in with your subscription (claude → /login). Leave ANTHROPIC_API_KEY unset: Jetstream strips it from anything it spawns, so a keypress can never silently bill the metered API.

Commands

| Command | What it does | | ------------------- | ----------------------------------------------------------- | | jetstream install | Hand the packed plugin to the Stream Deck app | | jetstream chat | Build/arrange your board by describing it in plain English | | jetstream init | Guided setup — repos, theme, timings, a ready-made layout | | jetstream setup | Hooks + a starter projects.json | | jetstream update | Bump the npm package and reinstall the plugin in one step | | jetstream hooks install | Wire only the Claude Code hooks (--tool-detail, --replace-statusline) | | jetstream doctor | Read-only health check for when the board isn't lighting up |

install, update, and version/-v/--version are handled by this package; every other verb is forwarded to the installed plugin's own CLI, so install first.

Docs

Full documentation, key reference, and configuration: github.com/pimmesz/jetstream

Licensed under Apache-2.0.