SnapBack

Quick Start Guide

Git tracks what changed. SnapBack understands who changed it and why.

Your AI assistant’s intelligent safety layer. Automatic AI detection, context capture, and pattern learning.

Goal: You’ll have full visibility into AI-assisted development in under 2 minutes. Zero configuration required.

Which AI assistant are you using?

Choose your AI coding assistant to see the specific setup instructions:


🔵 Cursor / GitHub Copilot Setup

Since Cursor and Copilot run inside VS Code, setup is incredibly simple:

Install the Extension (30 seconds)

Open VS Code or Cursor and install SnapBack:

Option A: Quick Install

  1. Click this link: Install SnapBack
  2. Allow your editor to open the extension
  3. Click “Install”

Option B: Manual Install

  1. Press ⌘+Shift+X (Mac) or Ctrl+Shift+X (Windows/Linux)
  2. Search for “SnapBack”
  3. Click Install

🎉 You’re Protected! SnapBack activates automatically. No configuration needed.

Verify It’s Working

  1. Look for the 🧢 SnapBack icon in your status bar (bottom of VS Code)
  2. Open any file and make a small change with your AI assistant
  3. Save the file (Cmd+S or Ctrl+S)

SnapBack is now capturing AI changes with full context. When Cursor or Copilot makes edits, SnapBack creates protection states with AI attribution, risk scoring, and pattern analysis.

What just happened:

  • ✅ AI detection active (89% accuracy)
  • 🛡️ Automatic context capture on every save
  • ⏱️ Pattern learning begins
  • 📊 Full AI attribution for every change

Next: Learn how SnapBack works or jump to AI Detection details


🤖 Claude Desktop Setup

Claude Desktop needs MCP (Model Context Protocol) configuration for SnapBack integration:

Install the SnapBack CLI

# Install globally via npm
npm install -g @snapback/cli

# Verify installation
snap --version

Auto-Configure MCP

# Auto-configure Claude Desktop
snap tools configure --claude

This creates the MCP configuration automatically. Now restart Claude Desktop.

Verify It’s Working

  1. Open Claude Desktop
  2. Look for “snapback” in the MCP servers list
  3. Install the VS Code extension for additional protection:
    • Press ⌘+Shift+X and search “SnapBack”

🎉 You’re Protected! Claude can now access SnapBack’s risk intelligence through MCP tools.

Available MCP Tools:

  • snap - Start tasks with risk context
  • check - Validate code against patterns
  • snap_end - Complete tasks and capture learnings

Next: See full MCP tool reference or Configure more integrations


🌊 Windsurf Setup

Windsurf needs MCP configuration similar to Claude Desktop:

Install the SnapBack CLI

# Install globally via npm
npm install -g @snapback/cli

# Verify installation
snap --version

Auto-Configure MCP

# Auto-configure Windsurf
snap tools configure --windsurf

This creates the MCP configuration automatically. Now restart Windsurf.

Verify It’s Working

  1. Open Windsurf
  2. Look for “snapback” in the MCP servers list
  3. The SnapBack extension should activate automatically (Windsurf is VS Code-based)

🎉 You’re Protected! Windsurf now has access to SnapBack’s intelligence.

Next: Learn about MCP integration or View Windsurf-specific docs


🔧 Multiple AI Tools Setup

Using Cursor, Claude Desktop, and Windsurf together? Setup once, protect everywhere:

Install CLI & Extension

# Install CLI for MCP tools
npm install -g @snapback/cli

# Install VS Code extension for Cursor/Windsurf
# Press ⌘+Shift+X, search "SnapBack", install

Configure All MCP Tools

# Auto-configure all detected AI assistants
snap tools configure --all

# Or configure specific ones
snap tools configure --claude --windsurf

Restart each AI assistant after configuration.

Verify It’s Working

  • Cursor/Windsurf: Look for 🧢 icon in status bar
  • Claude Desktop: Check “snapback” appears in MCP servers

🎉 You’re Protected Everywhere! All your AI assistants now have SnapBack intelligence.

Next: Understand how it all works


What Happens Next

SnapBack is now running in the background, building your intelligence layer:

🤖 AI Attribution

89% accuracy detecting and attributing AI changes

📊 Context Capture

Rich context with every change: cursor, files, risk score

🧠 Pattern Learning

Builds knowledge of YOUR codebase patterns over time

Your Code Never Leaves Your Machine

Privacy First: All monitoring happens locally. No cloud, no account required, no tracking. Optional cloud features use metadata only.

What’s Next?

🎯 Understand the Intelligence Layer (10 min)

🧠 How SnapBack Works

AI detection, context capture, and the intelligence layer

Read →

📈 Pattern Learning

How SnapBack learns YOUR codebase patterns over time

Read →

🤖 AI Detection

How SnapBack detects and attributes AI-generated changes

Read →

🔧 Advanced Usage

🏢 Team Features

  • Audit trails - See who changed what, when, and why
  • Organization scoping - Multi-tenant data isolation
  • GDPR compliance - Data export, deletion, anonymization

Explore enterprise features →

Need Help?

🎉 Your Intelligence Layer is Active! SnapBack is now capturing every AI change with full context. AI attribution, pattern learning, and timeline navigation are all working automatically. Work faster with AI—SnapBack has your back.

Privacy First: SnapBack works 100% offline on the Free plan. MCP is optional and requires explicit consent on paid plans. Learn more →