Keyboard shortcuts for plugin commands

[BrentonWheeler]

What I'm trying to do

I use a few plugin views many times a day (a pull request list, a planner). I'd like a single key combo to open each one, the way built-in shortcuts open a new agent or workspace.

How I do it today

I register each view as a command center item (client.addCommandCenterItem) and open it with: command center → type → Enter. That works but it's three steps every time.

The only way to get one key is to add a keydown listener on window from the plugin's client contribution. That only works where there is a DOM (desktop and web, not mobile), clashes with Paseo's own shortcuts and focus scopes, doesn't appear in the shortcut list in Settings, and can't be rebound. From that root context there's also no openPanel, only openSurface.

Where Paseo gets in the way

• @getpaseo/plugin has no shortcut, keybinding or accelerator API.
• Paseo already has a full shortcut system (packages/app/src/keyboard/): bindings for each action, focus scopes, a help search, and user overrides in Settings that can rebind or clear a shortcut. But the bindings are a fixed list of built-in KeyboardActionIds, so plugin commands can't be added to it.

What a better workflow would look like

Let plugin command center items take part in the existing shortcut system:

1. Each plugin command center item gets a row in the shortcut settings, unassigned by default, so the user picks the combo and plugins can't grab keys on their own.
2. Optionally, a plugin can suggest a default, e.g. addCommandCenterItem({ ..., shortcut: "mod+shift+p" }). Paseo only uses it if nothing else has that combo.
3. Pressing the combo runs the item's onSelect with the same context the command center would pass (so workspace and agent items still get openPanel), and does nothing when that context isn't available.

[rvnikita]

+1, with a concrete case: jumping to the next agent that needs attention.

The sidebar already knows which agents are waiting (needs input / failed / ready to review), and plugins can reach that through openAgent / openWorkspace. So a "next agent needing attention" plugin is easy to write as a command center item, but cycling through a queue of waiting agents with ⌘K → type → Enter for each one defeats the purpose. It needs one rebindable key.

A client.addShortcut({ id, title, defaultKeys, onTrigger }) that joins the existing shortcut system (listed in Settings → Shortcuts, rebindable, scoped to focus) would cover this and the cases above. (The built-in version of this navigation was requested in #2519, now in #4495.)

[andresantoniuk]

Same need from the agent-monitor side: multihost roster, graph and mission control (tracking in omercnet/paseo-plugins#365, interactive graph merged in omercnet/paseo-plugins#364, implementation in omercnet/paseo-plugins#424). It adds an Agent overview grid with every running or attention-needing agent across hosts, driven by digits once open. Today it takes Cmd+K, type, Enter to summon; the whole point is one keypress: glance, pick a number, land on the agent. +1 for unassigned-by-default rows in Settings that the user binds; a suggested default used only if free sounds right. Happy to help implement or test against the plugin.

[jozuas]

I'm building a plugin, and ran into the same problem, would be nice to be able to assign a keyboard shortcut to my new plugin tab