Guides

March 5, 2026 · View on GitHub

How-to docs for working with and contributing to Cursor Drive.

Files

FileWhat it covers
getting-started.mdFirst-time setup, build, run, project layout overview
live-testing.mdFull smoke test suite for extension + plugin layer + hooks
handoff.mdHandoff prompt for new chat sessions — paste into Cursor to continue work
demo-mcp-apps.mdSelf-hosted demo: MCP Apps, port fallback, defaults, walkthrough
cloudflare-workers-mcp-cicd.mdDeploy remote MCP to Cloudflare Workers via CI/CD and Terraform IaC
dev-host-disabled-extensions.mdWhy we disable cursor-socket and cursor-resolver-helper in the Extension Dev Host
webview-dev-and-events.mdWebview hot reload, event listener breakpoints, VS Code event catalog

Quick answers

How do I run the extension?getting-started.md

How do I test that the MCP server works?live-testing.md § B — MCP server

How do I continue in a new chat? → Copy handoff.md into a new chat

Operators and Agent Screen (S-AS)? → Current terms per ADR-0016; see reference/mcp-tools.md for MCP tools.

How do I demo MCP Apps self-hosted?demo-mcp-apps.md

How do I deploy a remote MCP server to Cloudflare Workers?cloudflare-workers-mcp-cicd.md