{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cursor Integration","description":"Control the power of AI Agents in runtime.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cursor-integration","__idx":0},"children":["Cursor Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect your Cursor IDE to Capsule Security for complete visibility into AI coding assistant activity, including prompts, responses, shell commands, and MCP tool usage."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This integration uses Cursor's hooks system to capture AI coding assistant activity."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/cursor-hooks.a099784396fab503bc54671f525479342dd230f3fe97d7c845ccb1f5bce637b6.9c1bb791.gif","alt":"Cursor Hooks"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following hooks are configured:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Hook"},"children":["Hook"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["beforeSubmitPrompt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User prompts before submission to the AI"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["afterAgentResponse"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI assistant responses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["afterAgentThought"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agent reasoning and thought processes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["afterShellExecution"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shell commands and their output"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["afterMCPExecution"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MCP tool calls and results"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cursor IDE"]}," installed (version 0.40 or later recommended)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," account with admin access"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-obtain-your-configuration-file","__idx":3},"children":["Step 1: Obtain Your Configuration File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact the Capsule Security support team to receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," configuration file customized for your organization."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-hooks-using-cloud-distribution-enterprise-only","__idx":4},"children":["Install the hooks using Cloud Distribution (Enterprise Only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enterprise teams can leverage Cursor's native cloud distribution system to automatically synchronize hooks across their organization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Features:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Centralized management through the Cursor web dashboard"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatic synchronization to all team members (every 30 minutes)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Operating system targeting for platform-specific hooks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No manual deployment to individual machines required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access the Cursor web dashboard"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the team content section under Hooks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload or configure the hooks provided by Capsule Security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The platform automatically delivers configurations to all authenticated team members"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-hooks-using-mdm-distribution","__idx":5},"children":["Install the hooks using MDM Distribution"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations using Mobile Device Management (MDM) tools, deploy hooks to the following system-wide locations:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Platform"},"children":["Platform"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["macOS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/hooks.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Linux/WSL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/etc/cursor/hooks.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Windows"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C:\\ProgramData\\Cursor\\hooks.json"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MDM-based distribution is fully managed by your organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your internal IT or security team is responsible for configuration, deployment, and updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Leverage your existing MDM infrastructure while maintaining control over hook distribution"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-hooks-using-kandji-distribution-macos","__idx":6},"children":["Install the hooks using Kandji Distribution (macOS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations using Kandji MDM, deploy the hooks configuration using a Custom App."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/kandji.c85e00be11fccc4f7524cc80bd96b7b4845665f5e373d6a988cdb3c100ba0e52.9c1bb791.png","alt":"Kandji"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup Steps:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your Kandji tenant"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Library > Custom Apps"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add New"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom App"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the installation:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},": Capsule Security Cursor Hooks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install Type"]},": Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ZIP File (unzip contents into specified directory)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unzip Location"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Preinstall Script"]},":",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"#!/bin/bash\n\n# Create the Cursor directory if it doesn't exist\nmkdir -p \"/Library/Application Support/Cursor\"\n\n# Set appropriate permissions\nchmod 755 \"/Library/Application Support/Cursor\"\n\necho \"Directory created successfully\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hooks.json"]}," file from the Capsule Security portal:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Integrations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Locate the Cursor integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a ZIP archive containing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file:",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"zip hooks.zip hooks.json\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hooks.zip"]}," file to the Custom App"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign the Custom App to the appropriate devices or Smart Groups"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deploy the configuration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The preinstall script ensures the target directory exists with proper permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ZIP file will be extracted directly into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Restart Cursor on target devices after deployment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updates can be deployed by modifying the Custom App and incrementing the version"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-hooks-using-jamf-pro-distribution-macos","__idx":7},"children":["Install the hooks using Jamf Pro Distribution (macOS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations using Jamf Pro, deploy the hooks configuration using Jamf Composer to create a package with a preinstall script."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup Steps:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hooks.json"]}," file from the Capsule Security portal:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Integrations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Locate the Cursor integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://app.jamfnow.com/account/composer"},"children":["Jamf Composer"]}]}," on your Mac"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new package source by dragging:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Finder and create the directory structure locally: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Place the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file inside this directory"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important"]},": Composer captures the exact file structure, so the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file must already be in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/"]}," before dragging into Composer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drag only the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]}," folder directly into Composer's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sources"]}," panel on the left sidebar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A new package source will be created automatically with the correct directory structure"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the package destination:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the left sidebar, right-click on the newly created package source"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Package"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Package Settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the installation location:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the destination is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/"]}," (root) so files install to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/Library/Application Support/Cursor/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file is mapped to be installed in the correct location"]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Preinstall Script"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expand the Package under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sources"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Right-click on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scripts"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Shell Script > preinstall"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the following script:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"#!/bin/bash\n\n# Create the Cursor directory if it doesn't exist\nmkdir -p \"/Library/Application Support/Cursor\"\n\n# Set appropriate permissions\nchmod 755 \"/Library/Application Support/Cursor\"\n\necho \"Directory created successfully\"\nexit 0\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Build the package:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Build as PKG"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the package with a descriptive name (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CapsuleCursorHooks.pkg"]},")"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upload the package to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Jamf Pro"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your Jamf Pro console"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Computer Management > Packages"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}," and upload the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pkg"]}," file"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure display name and category"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Policy"]}," to deploy the package:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Computers > Policies"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the policy:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},": Deploy Capsule Security Cursor Hooks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Trigger"]},": Recurring Check-in (or your preferred trigger)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Execution Frequency"]},": Once per computer"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Packages"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure"]}," and add your package"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scope"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scope"]}," tab"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add target computers, computer groups, or departments"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save and deploy the policy"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The preinstall script ensures the target directory exists with proper permissions before file deployment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Packages must be in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pkg"]}," format to support preinstall scripts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To update the configuration, create a new package version and update the policy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consider using Smart Groups for dynamic targeting and rollout"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"install-the-hooks-using-microsoft-sccm-distribution-windows","__idx":8},"children":["Install the hooks using Microsoft SCCM Distribution (Windows)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations using Microsoft System Center Configuration Manager (SCCM), deploy the hooks configuration as an SCCM Application with a script installer."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup Steps:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hooks.json"]}," file from the Capsule Security portal:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Integrations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Locate the Cursor integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Place the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file on a network share accessible by your SCCM distribution points:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\\\\sccm-server\\sources\\Software\\CapsuleCursorHooks\\hooks.json\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SCCM Console"]}," and navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Library > Application Management > Applications"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Application"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manually specify the application information"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},": Capsule Security Cursor Hooks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Publisher"]},": Capsule Security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": Deploys Cursor hooks configuration for Capsule Security monitoring"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deployment Type"]}," with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Script Installer"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content location"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\\\sccm-server\\sources\\Software\\CapsuleCursorHooks\\"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Install command"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"cmd","header":{"controls":{"copy":{}}},"source":"cmd.exe /c mkdir \"C:\\ProgramData\\Cursor\" & copy /Y \"hooks.json\" \"C:\\ProgramData\\Cursor\\hooks.json\"\n","lang":"cmd"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Uninstall command"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"cmd","header":{"controls":{"copy":{}}},"source":"cmd.exe /c del \"C:\\ProgramData\\Cursor\\hooks.json\"\n","lang":"cmd"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Detection Method"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Path"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C:\\ProgramData\\Cursor"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Property"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File or folder exists"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Experience"]}," settings:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Installation behavior"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Install for system"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Logon requirement"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether or not a user is logged on"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Installation program visibility"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hidden"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum allowed run time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 minutes"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Distribute Content"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Right-click the application and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Distribute Content"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your distribution point groups"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the wizard"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a Deployment"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Right-click the application and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deploy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the target ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device Collection"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Action"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Install"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purpose"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Schedule"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As soon as possible (or a maintenance window)"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The hooks file is deployed to the system-wide path ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C:\\ProgramData\\Cursor\\"]}," so it applies to all users on the machine"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Since this is a system-level deployment, target ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device Collections"]}," rather than User Collections"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To update the configuration, replace the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hooks.json"]}," file on the network share and create a new deployment or use SCCM's content update and redeployment workflow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Restart Cursor on target devices after deployment for the hooks to take effect"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consider using SCCM Maintenance Windows to control when deployments occur"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"restart-cursor","__idx":9},"children":["Restart Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After placing the configuration file, restart Cursor to activate the hooks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps","__idx":10},"children":["Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Close all Cursor windows"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reopen Cursor"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify the hooks are active:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Cursor Settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hooks"]}," tab"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the hooks are listed and enabled"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-integration","__idx":11},"children":["Verify the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test that events are being captured in Capsule."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps-1","__idx":12},"children":["Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open a project in Cursor"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the AI assistant (Cmd+K or Agent Chat) to execute a task"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," portal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory > Agents"]}," and confirm your agent is displayed."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on your agent and review the audit logs to verify events are being captured."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the full conversation, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Observability → Filter Activity Type - Session"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"troubleshooting","__idx":13},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If events are not appearing, please contact the Capsule Security support team for assistance."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":14},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For help with this integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email"]},": support@capsule.security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Include"]},": Your organization ID, integration status, and any error messages"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":15},"children":["References"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://cursor.com/docs/agent/hooks"},"children":["Cursor Hooks Documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://cursor.com/docs/agent/hooks#cloud-distribution-enterprise-only"},"children":["Cloud Distribution (Enterprise Only)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://cursor.com/docs/agent/hooks#mdm-distribution"},"children":["MDM Distribution"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.jamf.com/composer/10.25.0/user-guide/Creating_Package_Sources.html"},"children":["Jamf Composer User Guide - Creating Package Sources"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.jamf.com/composer/10.25.0/user-guide/Building_Packages_from_Package_Sources.html"},"children":["Jamf Composer User Guide - Building Packages"]}]}]}]},"headings":[{"value":"Cursor Integration","id":"cursor-integration","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Obtain Your Configuration File","id":"step-1-obtain-your-configuration-file","depth":2},{"value":"Install the hooks using Cloud Distribution (Enterprise Only)","id":"install-the-hooks-using-cloud-distribution-enterprise-only","depth":2},{"value":"Install the hooks using MDM Distribution","id":"install-the-hooks-using-mdm-distribution","depth":2},{"value":"Install the hooks using Kandji Distribution (macOS)","id":"install-the-hooks-using-kandji-distribution-macos","depth":2},{"value":"Install the hooks using Jamf Pro Distribution (macOS)","id":"install-the-hooks-using-jamf-pro-distribution-macos","depth":2},{"value":"Install the hooks using Microsoft SCCM Distribution (Windows)","id":"install-the-hooks-using-microsoft-sccm-distribution-windows","depth":2},{"value":"Restart Cursor","id":"restart-cursor","depth":2},{"value":"Steps","id":"steps","depth":3},{"value":"Verify the Integration","id":"verify-the-integration","depth":2},{"value":"Steps","id":"steps-1","depth":3},{"value":"Troubleshooting","id":"troubleshooting","depth":3},{"value":"Support","id":"support","depth":2},{"value":"References","id":"references","depth":2}],"frontmatter":{"seo":{"title":"Cursor Integration"}},"lastModified":"2026-03-18T17:35:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cursor","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}