Skip to content

About

See which Orca agent needs you: every pane on a Stream Deck key, one press to focus it

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

Agent Deck for Orca

Running several agents at once is like...

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

What you get

  • 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).

Requirements

  • macOS 13+, Windows 10+ or Linux, with Orca 1.4.248 or newer and the orca shell 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.

Install

  1. Download the Stream Deck plugin from the latest release and double-click it.
  2. Install the Orca plugin: paste https://github.com/1am/orca-agent-deck into 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.

Docs

Development

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-plugin

Load the Orca plugin from orca-plugin/, not the repository root. More in Architecture.

Support

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.

Thanks

Windows support was tested and helped along by @jondmarien.

License

MIT

About

See which Orca agent needs you: every pane on a Stream Deck key, one press to focus it

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages