Skip to main content
đŸ“ĻOperational Tools
💰

Costs

Monthly:ÂŖ40.00
Annual:ÂŖ480.00
🔑

Access

INTERNAL
ℹī¸

AI-powered code editor for development work, documentation, and automation scripts

Cursor

Purpose: AI-powered code editor that enhances development productivity through intelligent code completion, refactoring, and documentation generation. Primary IDE for all development work including documentation sites, automation scripts, and tool integrations.

Where it runs: Desktop application (macOS, Windows, Linux) with cloud-based AI features.

Last verified: December 2025

Overview​

Cursor is our primary development environment, combining the power of VS Code with advanced AI capabilities. We use Cursor to plan, build, and maintain multiple tech stacks across client projects. Beyond development, Cursor enables client management workflows, automation scripting, and content creation tasks.

Key capabilities:

  • AI-powered code completion and suggestions
  • Context-aware refactoring and code generation
  • Integrated terminal and Git workflow
  • MCP (Model Context Protocol) server integration for external tools
  • Multi-file editing and project-wide understanding
  • Project Rules system for consistent AI behaviour across workspaces

Current Use​

Development Work:

  • Docusaurus documentation site development
  • Automation scripts (Node.js, bash)
  • API integration code (TwentyCRM, Webflow, n8n)
  • Build scripts and tooling
  • React component development

Tech Stack Management:

  • Planning and architecting client tech stacks
  • Building integrations between tools (TwentyCRM, Webflow, n8n, etc.)
  • Maintaining and updating existing integrations
  • Documentation and knowledge management

Client Management:

  • Client-specific workspace configurations
  • Project documentation and setup guides
  • Tool integration workflows
  • Automation script development

Content Creation:

  • Technical documentation writing
  • Blog post and CMS content generation
  • Code documentation and comments
  • README files and setup guides

Configuration:

  • Project Rules system (.cursor/rules/) for structured AI guidelines
  • Legacy .cursorrules files (being migrated to Project Rules)
  • MCP server connections (Webflow, Context7, Browser)
  • Git integration for version control
  • Workspace-specific settings and extensions

Account Details​

  • Category: OPERATIONAL_TOOLS
  • Account type: INTERNAL
  • Monthly cost: ÂŖ40.00 GBP
  • Account owner: Ben Power
  • Access: Desktop application, cloud AI features

Installation and Setup​

Installing Cursor​

Official Documentation: Cursor Docs

macOS Installation​

  1. Download the installer:

  2. Install the application:

    • Open the downloaded .dmg file
    • Drag the Cursor application icon into your "Applications" folder

  3. Launch Cursor:

    • Open "Applications" folder
    • Double-click the Cursor icon to start the editor
    • First launch will guide you through initial setup (keyboard shortcuts, theme, terminal preferences)

Windows Installation​

  1. Download the installer:

  2. Run the installer:

    • Locate the downloaded .exe file and double-click to launch
    • Follow on-screen prompts (default installation path is recommended)
    • Click "Install" and wait for completion
    • Click "Finish" to launch Cursor

First-Time Setup​

Upon first launch, you'll be guided through:

  • Keyboard shortcuts: Choose familiar shortcuts (VS Code, Sublime, etc.)
  • Theme selection: Pick a visual theme
  • Terminal preferences: Configure terminal settings

You can revisit setup anytime: Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) → search "Cursor: Start Onboarding"

Creating an Account​

While Cursor works without an account, signing up unlocks all AI features:

  • Prompted during initial setup, or sign up later in Settings (Ctrl+Shift+J or Cmd+Shift+J)
  • Manage account at cursor.com/dashboard

Codebase Indexing​

When you open a project, Cursor automatically indexes your code:

  • Indexing starts automatically (1-15 minutes depending on project size)
  • More context = smarter suggestions
  • Teams can share indexes to save time
  • Monitor progress: Settings → Indexing & Docs

Common Installation Issues and Fixes​

Issue: Cursor won't launch on macOS

  • Solution: Check System Preferences → Security & Privacy → allow Cursor to run
  • If blocked, right-click Cursor → Open (first time only)

Issue: Node.js/npm not found errors

  • Solution: Install Node.js from nodejs.org (LTS version recommended)
  • Verify: node --version and npm --version in terminal
  • Restart Cursor after installing Node.js

Issue: MCP servers not working

  • Solution: Ensure Node.js is installed (MCP servers require npm)
  • Check internet connection (servers download via npx)
  • Verify MCP configuration in Cursor Settings → MCP Servers
  • Restart Cursor after configuration changes

Issue: Git integration not working

  • Solution: Install Git from git-scm.com
  • Verify: git --version in terminal
  • Configure Git user: git config --global user.name "Your Name" and git config --global user.email "your@email.com"

Issue: Slow indexing or high CPU usage

  • Solution: Large projects take time to index (normal)
  • Exclude unnecessary folders via .cursorignore file
  • Check Settings → Indexing & Docs for progress
  • First-time indexing is slower; subsequent opens are faster

Issue: AI features not working

  • Solution: Ensure you're signed in (Settings → Account)
  • Check internet connection (AI features require cloud access)
  • Verify subscription status if using premium features
  • Restart Cursor if issues persist

Installing Common Libraries​

Node.js packages (for MCP servers and scripts):

# Install Node.js first (see above)
npm install -g npm@latest  # Update npm to latest

# MCP servers install automatically via npx
# No manual installation needed

Python packages (if using Python scripts):

# Install Python from python.org
python --version  # Verify installation

# Install packages as needed
pip install package-name

Git (for version control):

  • macOS: Usually pre-installed, or install via Xcode Command Line Tools: xcode-select --install
  • Windows: Download from git-scm.com

Workspace Setup​

Standard Configuration:

  • Project Rules system (.cursor/rules/) for structured AI guidelines
  • Legacy .cursorrules files (being migrated to Project Rules format)
  • Git workflow integration
  • MCP servers for external tool access
  • Code style: British English, specific conventions
  • Documentation requirements per project

Project Rules System​

This workspace uses Cursor's Project Rules format (.cursor/rules/) instead of the legacy .cursorrules file. This provides better organisation, version control, and flexible scoping.

Rule Structure:

  • Each rule is a folder containing a RULE.md file with frontmatter metadata
  • Rules can be set to alwaysApply: true or scoped to file patterns via globs
  • Rules are focused and composable (under 500 lines each)

Current Rules (in .cursor/rules/):

  1. core-context-awareness - Quick reference, file type identification, context awareness requirements
  2. documentation-hygiene - File organisation, documentation structure, never create unnecessary files
  3. language-style - British English, tone guidelines, content rules
  4. safety-verification - Multi-user workspace safety, Git safety rules
  5. docusaurus-workflow - Docusaurus development workflows (scoped to docusaurus/**/* and tools/**/*)

Rule Configuration Example:

---
description: "Rule description for AI relevance"
alwaysApply: true  # or false
globs:
  - "docusaurus/**/*"  # Optional file patterns
---

Viewing Rules:

  • Cursor Settings → Rules, Commands - View and manage rules in UI
  • Rules are stored in .cursor/rules/ directory
  • See .cursor/rules/README.md for complete documentation

Migration from .cursorrules:

  • Legacy .cursorrules files are being migrated to Project Rules format
  • Benefits: Better organisation, version control, flexible scoping, future-proofing
  • Both formats work, but Project Rules is recommended for new workspaces

MCP Servers:

  • Webflow MCP: CMS operations, content management, schema queries
  • Context7 MCP: Library documentation and code examples
  • Browser MCP: Web testing and interaction

See Also:

  • .cursor/rules/README.md - Complete Project Rules documentation
  • docusaurus/docs/prompts/development/cursor-new-workspace.md - Workspace setup prompts

Advanced Features and Workflows​

Clever Cursor Features We Use​

Project Rules System:

  • Structured rule organisation in .cursor/rules/ directory
  • Composable rules with file pattern scoping
  • Better version control and team sharing
  • See .cursor/rules/README.md for setup

MCP Server Integration:

  • Webflow MCP: Direct CMS operations, schema queries, content updates
  • Context7 MCP: Real-time library documentation lookups
  • Browser MCP: Automated web testing and interaction
  • Enables AI to interact with external tools directly

Multi-File Context Understanding:

  • Project-wide indexing for accurate suggestions
  • Understands relationships between files
  • Refactors across multiple files safely
  • Maintains context across large codebases

AI Chat & Composer:

  • Chat for questions and explanations
  • Composer for multi-file code generation
  • Context-aware suggestions based on project structure
  • Refactors complex code blocks in seconds

Workspace-Specific Configurations:

  • .cursorignore for excluding files from indexing
  • .cursorindexingignore for fine-grained control
  • Project Rules for consistent AI behaviour
  • MCP server configurations per workspace

Git Integration:

  • Built-in terminal for Git commands
  • Visual diff and merge tools
  • Branch management in UI
  • Commit message suggestions

Documentation Generation:

  • AI-powered documentation writing
  • Code comment generation
  • README file creation
  • Technical documentation templates

Workspace-Specific Features​

Tool Documentation Sync:

  • Automated sync from tools/*.md to Docusaurus
  • TwentyCRM integration for account management
  • AI-powered note generation for tool overviews
  • See scripts/sync-tools/AGENT_WORKFLOW.md for details

Prompt Templates:

  • Reusable prompts for common tasks
  • Workspace setup templates
  • Development workflow prompts
  • See docusaurus/docs/prompts/ for examples

Multi-User Workspace Support:

  • Google Drive shared folder compatibility
  • Git workflow for conflict resolution
  • Team-shared indexes for faster onboarding
  • See docs/GIT_WORKFLOW.md for details

Resources​

Note Context

Importance Rating: Critical - Primary development environment and IDE for all development work

Focus Areas for Note:

  • Emphasize Cursor as the primary IDE for all development work (Docusaurus, automation scripts, integrations)
  • Highlight AI-powered capabilities and how they enhance productivity
  • Include MCP integration and project rules system
  • Note multi-user workspace support and Google Drive compatibility
  • Mention client management workflows and tech stack planning capabilities

Additional Context:

  • This is the core development tool used daily for all coding work
  • Focus on current usage patterns and capabilities
  • Include information about project rules and workspace setup
  • Note integration with other tools (TwentyCRM, Webflow, n8n) via MCP

Last Updated: December 2025
Owner: Ben Power
Status: Active