Cursor

​

Prerequisites

• Cursor installed (Get Cursor)
• Node.js 18+ installed
• ShadowGit desktop app running with tracked repositories

​

Quick Setup

1. Install the MCP server:
   Copy

   Ask AI

   npm install -g shadowgit-mcp-server
   

2. Open Cursor Settings:
   • Press Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows/Linux)
   • Search for Cursor Settings in the search bar
   • Click on Tools and Integrations
   • Under MCP Tools, click on Add Custom MCP
3. Add ShadowGit configuration:
   Copy

   Ask AI

   {
     "mcpServers": {
       "shadowgit": {
         "command": "shadowgit-mcp-server"
       }
     }
   }
   

4. Restart Cursor to activate the MCP server

​

Verify Installation

What ShadowGit repositories are available?

​

What Cursor can now do

​

Instant debugging

Why is this function returning null? Check what changed in the last hour.

​

Code archaeology

Find when this bug was introduced by checking the history of auth.ts

​

Smart suggestions

Based on my recent changes, what's the best way to refactor this?

​

Pattern recognition

Have I fixed similar issues before in this project?

​

Using ShadowGit in Cursor

​

In Chat (Cmd+K)

@shadowgit show me recent changes to the login flow

@shadowgit when did the tests last pass?

@shadowgit what files changed together with api.ts?

​

In Composer (Cmd+I)

Refactor this authentication flow. Check @shadowgit for what approaches 
I've tried before and avoid the patterns that didn't work.

​

During debugging

This error started appearing today. @shadowgit check what changed 
in the last 24 hours that could cause this.

​

Advanced Configuration

​

Custom installation path

{
  "mcpServers": {
    "shadowgit": {
      "command": "/usr/local/bin/shadowgit-mcp-server"
    }
  }
}

​

With environment variables

{
  "mcpServers": {
    "shadowgit": {
      "command": "shadowgit-mcp-server",
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

​

Example Workflows

​

Morning debugging session

1. Check overnight changes:
   Copy

   Ask AI

   @shadowgit what changed since yesterday evening?
   

2. Find breaking changes:
   Copy

   Ask AI

   @shadowgit when did the tests last pass? Show me the diff.
   

3. Quick fix:
   Copy

   Ask AI

   Based on @shadowgit history, revert just the breaking change
   

​

Code review preparation

@shadowgit summarize all changes to the auth module this week

​

Learning from history

@shadowgit show me all the different ways I've implemented this feature

​

Troubleshooting

​

Cursor doesn’t see ShadowGit

1. Confirm installation:
   Copy

   Ask AI

   which shadowgit-mcp-server
   

2. Check Cursor logs:
   • Help → Toggle Developer Tools
   • Check Console for MCP errors
3. Restart Cursor completely:
   • Quit Cursor (Cmd+Q / Alt+F4)
   • Start Cursor fresh

​

”Command not found”

npm list -g shadowgit-mcp-server --depth=0

"command": "/Users/you/.npm-global/bin/shadowgit-mcp-server"

​

No repositories available

1. ShadowGit desktop app must be running
2. At least one repository must be tracked
3. Wait 3-5 minutes for first snapshots

​

Permission denied

1. System Preferences → Security & Privacy
2. Privacy → Full Disk Access
3. Add Cursor.app

​

Best Practices

​

1. Context-aware queries

@shadowgit show auth.ts changes that happened during failing tests

​

2. Time-box investigations

@shadowgit only show changes from the last 2 hours

​

3. Cross-file analysis

@shadowgit what other files usually change when I modify config.json?

​

4. Learn from patterns

@shadowgit how did I solve similar React rendering issues before?

​

Security

• Read-only access: Can’t modify your code or git history
• Local processing: Your code never leaves your machine
• Safe operations: Only non-destructive git commands allowed

​

Tips & Tricks

​

Quick history check

• Settings → Keyboard Shortcuts
• Search for “AI Chat”
• Add custom binding for “@shadowgit log -10”

​

Combine with Cursor’s context

Looking at @file:src/api.ts and @shadowgit history, 
why might this endpoint be failing?

​

Use for documentation

@shadowgit help me write docs by showing how this API evolved

​

Next Steps