cursor-sdk-for-hermes

Hard-won knowledge about the `cursor-sdk` Python package — what works, what blows up, and the workarounds that exist in this repo's proxy. Use when writing or modifying code that talks to `cursor_sdk` (AsyncClient, AsyncAgent, Run streams, RunResult), debugging "Bridge request failed" / "Local SDK agents require an explicit model" / "Task was destroyed but it is pending" errors, or evaluating whether to upgrade the pinned version. Skip if the work is plugin-side (ProviderProfile) or pure infrastructure (systemd, sessions cache); those are not SDK concerns.

End-to-end installer playbook for this repo — wires the cursor-composer plugin into Hermes, brings up the local cursor-sdk proxy as a managed systemd --user service, sets the CURSOR_API_KEY, and verifies the whole path works. Use when the user says "set up", "install", "get this running", "wire it into Hermes", "make it work on a fresh machine", "/setup", or when symlinks/proxy are broken after the repo was moved or renamed. Drives the steps for the agent; not a prose explainer. Skip for SDK-internal debugging (that's the cursor-sdk skill) or for understanding *why* the architecture is a proxy (that's the README).