Add Cursor hooks integration doc

Author: schacon

content/docs/features/ai-integration/ai-overview.mdx

@@ -9,10 +9,11 @@ If you're using AI agent tools like Cursor, Windsurf, or Claude Code, GitButler
 
 https://www.youtube.com/watch?v=J6xV_Wyz9zg
 
-There are currently two main ways to integrate AI tools with GitButler:
+There are currently three main ways to use AI tools with GitButler:
 
-1. **Using the MCP Server**: This method allows you to set up your AI agent to communicate with GitButler's MCP server, enabling features like automatic commits and save points.
-2. **Using the Hooks in Claude Code**: This method allows you to use GitButler's hooks to manage commits and branches directly from within the Claude Code environment.
+1. **Our Agents Tab**: If you have Claude Code setup, you can use our [Agents tab](/features/agents-tab) as a GUI for running Claude Code directly.
+2. **Using Hooks in Claude Code or Cursor**: This method allows you to use GitButler's CLI as hook commands to manage commits and branches in either Claude Code or Cursor.
+3. **Using the MCP Server**: This method allows you to set up your AI agent to communicate with GitButler's MCP server, enabling features like automatic commits and save points.
 
 ## Enabling the experimental feature flag
 

content/docs/features/ai-integration/cursor-hooks.mdx

@@ -0,0 +1,48 @@
+---
+title: Cursor Hooks
+description: Set up Cursor hooks to automatically manage commits and branches when using GitButler with AI coding in Cursor.
+---
+
+GitButler integrates seamlessly with Cursor through hooks that automatically manage your commits and branches while you're using AI coding features. This allows you to automatically maintain clean git history and organized virtual branches.
+
+Here's a short video showing how GitButler works with Cursor hooks:
+
+https://youtu.be/NOYK7LTFvZM
+
+Ok, let's get it set up.
+
+## Install the GitButler CLI
+
+First, you need to install the GitButler CLI, which can be done in your General settings. See the [MCP Server documentation](mcp-server) for more details on how to install the CLI.
+
+## Installing GitButler as a Hook
+
+Once the command line tool is installed, you can add the `but cursor` commands as hooks.
+
+You will need to create or edit your `~/.cursor/hooks.json` file (globally) or `[project]/.cursor/hooks.json` file (single project) to have `afterFileEdit` and `stop` hooks like this:
+
+```json
+{
+  "version": 1,
+  "hooks": {
+    "afterFileEdit": [
+      {
+        "command": "but cursor after-edit"
+      }
+    ],
+    "stop": [
+      {
+        "command": "but cursor stop"
+      }
+    ]
+  }
+}
+```
+
+## Using GitButler with Cursor
+
+Once the hooks are setup, Cursor will automatically call GitButler when it edits files and when it's done with a task, which will trigger GitButler to:
+
+- Create a branch if the chat session is new
+- Assign edits to an active branch
+- Commit with a message based on the prompt when a task is done

content/docs/features/ai-integration/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "AI Agent Integrations",
   "defaultOpen": false,
-  "pages": ["ai-overview", "mcp-server", "claude-code-hooks"]
+  "pages": ["ai-overview", "mcp-server", "claude-code-hooks", "cursor-hooks"]
 }