> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethandshake.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Connect Cursor to Handshake with an MCP registration and a Stop hook.

Handshake uses Cursor MCP support and agent hooks.

## Installed integration

`handshake setup` can install:

* An MCP entry in `~/.cursor/mcp.json`.
* A Stop hook in `~/.cursor/hooks.json`.
* `~/.cursor/hooks/handshake_cursor_stop.py`.

The Stop hook sends the completed turn to Handshake. If project knowledge is
stale, the hook can request one follow-up authoring action.

Cursor is not a supported unattended background writer.

## Connect Cursor

<Steps>
  <Step title="Check Python">
    Make sure that Python 3 is on `PATH`.
  </Step>

  <Step title="Run setup">
    Run:

    ```bash theme={null}
    handshake setup
    ```
  </Step>

  <Step title="Restart Cursor">
    Close and open Cursor.
  </Step>

  <Step title="Verify the connection">
    Enter:

    ```text theme={null}
    list my sessions
    ```
  </Step>
</Steps>

If Python 3 is not available, the MCP registration can still work but the Stop
hook is not installed.