# Cursor Sdk: Hermes Agent plugin

> Experimental model transport using the official Cursor Agent SDK.

Canonical: https://hermeswatcher.com/plugins/cursor-sdk  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/cursor-sdk  
Last updated in catalog: 2026-10-16

Experimental model transport using the official Cursor Agent SDK. Requests go to Cursor through its official SDK. The plugin cannot enforce an included-only spending cap and never changes account spending settings. Instructions use a Cursor project rule, not a native system-role override. Permission and prompt-hierarchy equivalence remain unqualified. The plugin spawns Node and a local SDK agent, runs Git initialization in a plugin-owned workspace, and writes project rules, hooks, and SDK state under its own runtime directory. That state may contain private conversation data and currently remains on disk. Credentials come from Hermes's profile-scoped secret accessor. No credential store or vendor token file is read directly by plugin code. Text-only, buffered responses. The bundled model snapshot is not live entitlement discovery. Optional picker hooks require Hermes support. This plugin does not patch the desktop.

## Good to know before installing

Spawns Node and a local Cursor Agent SDK worker per request (`npm ci` in the plugin dir installs Cursor's official native platform binaries from npm); sends the full conversation, system prompt and tool schemas to Cursor with your CURSOR_API_KEY; Cursor-native shell/file tools are denied by a fail-closed project hook and the run is cancelled if one fires, but that enforcement is not proven in every Cursor runtime; each request's workspace and conversation state stay under the plugin's runtime/ directory until you delete them.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `CURSOR_API_KEY`), then asks whether to turn it on.

```bash
hermes plugins install cursor-sdk
```

2. Said no? Turn it on later:

```bash
hermes plugins enable cursor-sdk
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: AI models & providers
- Maintained by: mcpeezy (Community)
- Needs: `CURSOR_API_KEY` (API key)
- Works on: macos, linux
- Requires Hermes: `>=0.22.0`
- Version: 0.1.0
- In the catalog since: 2026-10-16

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/cursor-sdk)
- [Source code](https://github.com/mcpeezy/hermes-cursor-sdk#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt