Live status of your Cursor Agents window agents on the Logitech MX Creative Keypad. Press a key to jump to one. A Logi Options+ plugin built on the Logi Actions SDK, with keys for new agents, side chats, and the Agents window's layout shortcuts. It is the Cursor counterpart of vscode-agents-window-logi-plugin and uses the same key colors.
Status: 0.1.0, first working version. Tested on the Keypad on macOS. Windows paths are written but untested.
The images are diagrams drawn from the plugin's own colors and icons, not photos.
Requires macOS, Cursor 3.27 or later, Logi Options+ with Logi Plugin Service 6.4 or later, and an MX Creative Keypad (or Loupedeck CT).
- Download
CursorAgentsWindow_<version>.lplug4from the latest release. - Double-click it. Logi Options+ installs the plugin.
- In Options+, select the Keypad, open All actions, and drag the actions below onto keys.
Drag these onto keys in Logi Options+ (group Cursor Agents Window):
| Action | What it does |
|---|---|
| Recent chat 1…9 | The Nth chat across all agents, side chats included, so an agent with several active side chats takes several keys: waiting for input first, then finished but unread, then working, then idle. Press opens it. A long press on a main chat asks Archive? and a press within 3 seconds archives the agent (Cursor then hides its side chats). A long press on a side chat does nothing for now (see below). |
| New agent | Brings up the Agents window and presses its New Agent shortcut (Cmd+N). While Cursor is not running the key reads Start Cursor (▶) and a press starts it. |
| Sidebar, Right Sidebar, Files, Terminal, Browser, Changes, Search (group Shortcuts) | Send the Cursor Agents window's keybinding for that view. macOS: ⌘B, ⌥⌘B, ⌘G, ⌘J, ⇧⌘B, ⌘E, ⇧⌘F. Windows (untested): Ctrl+B, Ctrl+Alt+B, Ctrl+G, Ctrl+J, Ctrl+Shift+B, Ctrl+E, Ctrl+Shift+F. The Agents window is brought to the front first; the keys are only sent once Cursor is frontmost. The key shows the view's codicon and name; the description in Options+ gives the shortcut. |
| Cursor shortcuts (folder, group Shortcuts) | Opens a folder with the system back key, New (as the New agent key), and the seven shortcut keys: one Keypad page. |
| Agents window (folder) | The system back key, New, then one key per agent, with a white badge for the number of chats when it has side chats. A press opens the agent. A long press opens its menu: Back, New chat (a side chat of that agent, Cmd+Shift+S), Archive (the agent and, with it, its side chats), and one key per chat, main chat first. In the menu, a press opens a chat and a long press on the main chat archives the agent; a long press on a side chat does nothing for now. Archiving asks for a second press within 3 seconds. |
An agent with no name yet (its first message has not been sent) shows its folder's name, since Cursor sets the name with the first message.
Keys show Cursor's logo in black on a disc colored by state, with the VS Code plugin's colors: red waiting for input, amber working, blue finished but not looked at yet, green idle, dark red Cursor not running, dark grey empty.
-
State: Cursor has no local API for agent sessions. Once a second, the plugin copies Cursor's global
state.vscdband its WAL (~/Library/Application Support/Cursor/User/globalStorage/on macOS) to a temp folder, only if they changed, and reads the copy. Agents and their side chats come from thecomposerHeaderstable; a side chat (subagentTypeName = 'side-chat') names its parent insubagentInfo.parentComposerId, and side chats of an archived agent are hidden, as Cursor hides them. Waiting ishasBlockingPendingActions(command approvals) or an openask_questioncard; unread ishasUnreadMessages; working is an unfinishedcomposerDatastatus while the agent's messages keep changing (Cursor leavesstatus: abortedbehind when an agent is stopped, so a status alone is not enough). It never writes to Cursor's storage and never reads message text. -
Focus: a press opens
cursor://anysphere.cursor-deeplink/agent?id=<composerId>, which brings up the Agents window on that agent. Cursor ignores the link when the agent's group is already selected, and restores the group's last active tab, which may be a side chat. So:- opening a side chat of the selected group first selects another agent, then the side chat. The window visibly flickers, which the user found acceptable;
- opening a main chat ends with Cmd+I (Focus Chat Input), which moves the cursor to the main chat. Coming from another group, the side chat may show for a moment first.
-
Side chats cannot be archived from the Keypad yet. Cursor archives with Cmd+Shift+E on the selected agent, and opening a side chat selects its parent, so the key would archive the whole group. Cursor's tab menu can archive a side chat on its own; a safe way to trigger it from the plugin is still being looked for.
-
New, New chat and Archive: Cursor has no link for these, so the plugin uses the Agents window's own shortcuts: Cmd+N, Cmd+Shift+S (new side chat of the selected agent), and Cmd+Shift+E (archive the selected agent). Before New chat or Archive it opens the agent, waits until Cursor's database reports it selected and Cursor is frontmost, and checks both again right before sending the keys.
-
Shortcuts: the Agents window link brings that window forward (Cursor's IDE window shares the app, so being frontmost is not enough),
lsappinfoconfirms Cursor is frontmost, then the Plugin Service'sKeyboardApi.SendShortcutpresses the keys. The bindings were read from Cursor 3.27's Agents window and checked on the Keypad; Files (⌘G) and Changes (⌘E) differ from VS Code, and Right Sidebar is Cursor's "Open Apps Panel".
src/CursorAgents.Core: everything that does not need the Logi API (database reader, state rules, ranking, links, shortcut sequencing). Tested directly.src/CursorAgentsWindowPlugin: the Logi plugin (actions, folders, key faces). The Plugin Service only loads it when the plugin class is named after the manifest'sname(CursorAgentsWindow→CursorAgentsWindowPlugin).src/CursorAgentsWindowPlugin/Icons: codicons (CC BY 4.0) for the shortcut keys, andcursor.svg, Cursor's logo as Cursor 3.27 draws it in its own layout icons.package/metadata/Icon256x256.png: the plugin icon, Cursor's app icon.tests/CursorAgents.Core.Tests: xUnit tests for the core, including a reader test against a database with Cursor's table layout.package/metadata/LoupedeckPackage.yaml: plugin manifest and the only version number.probes/CursorDbCli: prints the ranked agents (short ids and folder names only) as they change.
Requires the .NET 10 SDK, Logi Options+ with Logi Plugin Service 6.4 or later, and Cursor 3.27 or later.
dotnet test tests/CursorAgents.Core.Tests
dotnet build src/CursorAgentsWindowPlugin # Debug: links build/Debug into the Plugin Service and reloads it
dotnet clean src/CursorAgentsWindowPlugin # removes the link
dotnet run --project probes/CursorDbCli -- 60The log is at ~/Library/Application Support/Logi/LogiPluginService/Logs/plugin_logs/CursorAgentsWindow.log. A warning that the service "Cannot create dynamic action" for RecentAgentCommand is expected: the plugin adds those actions itself.
Set version in package/metadata/LoupedeckPackage.yaml, commit, and push a matching tag (git tag v0.1.0 && git push origin v0.1.0). The release workflow runs the tests, builds Release, packs and verifies CursorAgentsWindow_<version>.lplug4 with LogiPluginTool, and attaches it to a GitHub Release. To pack locally: dotnet build src/CursorAgentsWindowPlugin -c Release, then logiplugintool pack build/Release CursorAgentsWindow_<version>.lplug4. Remove a dev link with dotnet clean src/CursorAgentsWindowPlugin before installing the package.
MIT. See LICENSE. Codicons are CC BY 4.0.



