Running several agents at once is like...
Agent Deck for Orca shows the state of your agents and terminals running in Orca on a Stream Deck, and focuses a pane when you press its key. Easy to see where and when your attention is needed.
orca-agent-deck-v0_3_0-preview-output.mp4
Open in Orca's plugin directory
- Pane keys show each pane's state (working, needs input, awaiting reply, done, error, offline). Press one to focus that pane in Orca.
- Attention key counts the panes that need you.
- Status key shows setup checks.
- Agent Deck panel in Orca's right sidebar is where you map panes to keys. Open it by holding a key, clicking "Agent Deck" in Orca's status bar, or pressing Cmd+Alt+K (Ctrl+Alt+K on Windows and Linux).
- Works locally and over SSH, and with tmux (see Working with tmux).
- macOS 13+, Windows 10+ or Linux, with Orca 1.4.248 or newer and the
orcashell command registered. - The Elgato Stream Deck app 7.1+ (macOS, Windows) or OpenDeck (Linux), and a Stream Deck.
It has two parts and needs both: a Stream Deck plugin and an Orca plugin.
- Download the Stream Deck plugin from the latest release and double-click it.
- Install the Orca plugin: paste
https://github.com/1am/orca-agent-deckinto Orca's Settings, Plugins, Install from Git.
Offline install, building from source and first steps: Install and quick start.
Note
Early release, built for personal use: expect breaking changes and rough edges. Tested setups are listed in Compatibility.
- Install and quick start
- Troubleshooting
- Compatibility
- Working with tmux
- Known issues and limitations
- Architecture
- Bridge protocol
pnpm i
pnpm lint && pnpm typecheck && pnpm test
pnpm sd:dev # build, link into the Stream Deck app, rebuild on change
orca plugin dev load orca-pluginLoad the Orca plugin from orca-plugin/, not the repository root. More in Architecture.
An independent project, not affiliated with or endorsed by Stably (Orca) or Elgato (Stream Deck). Best effort, by one maintainer.
To report a problem, open an issue and attach the file from node collect-diagnostics.mjs (see Logs). Read it before attaching it.
Windows support was tested and helped along by @jondmarien.
