VS Code Commands Reference
All commands are available via the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux). Type “SnapBack” to filter.
Keyboard Shortcuts
| Shortcut | Mac | Windows/Linux | Command |
|---|---|---|---|
| Protect File | Cmd+Alt+P | Ctrl+Alt+P | Create protection on current file |
| Create Snapshot | Cmd+Alt+S | Ctrl+Alt+S | Manual snapshot of current file |
| SnapBack | Cmd+Alt+Z | Ctrl+Alt+Z | Restore last snapshot |
| Quick Restore | Cmd+Shift+R | Ctrl+Shift+R | Open restore picker |
Command Reference
Snapshot Commands
| Command | Title | Description |
|---|---|---|
snapback.createSnapshot | Create Snapshot | Create a manual snapshot of the current file |
snapback.snapBack | SnapBack (Restore) | Restore the current file to its last snapshot |
snapback.restoreLastSnapshot | Restore Last Snapshot | Quickly restore the most recent snapshot |
snapback.restoreFromSnapshot | Restore From Snapshot | Restore a specific file from a selected snapshot |
snapback.restoreAllRecent | Restore All Recent | Restore multiple files from recent snapshots in one operation |
snapback.undoLastRestore | Undo Last Restore | Revert the most recent restore operation back to its pre-restore state |
snapback.undoLastAIChange | Undo Last AI Change | Restore files changed by AI in the last edit |
snapback.showAllSnapshots | Show All Snapshots | View all snapshots in the workspace |
snapback.viewSnapshot | View Snapshot Details | View metadata and details of a snapshot |
snapback.compareWithSnapshot | Compare with Snapshot | Diff current file against a snapshot |
snapback.renameSnapshot | Rename Snapshot | Give a snapshot a descriptive name |
snapback.protectSnapshot | Protect Snapshot | Prevent a snapshot from being auto-deleted |
snapback.deleteSnapshot | Delete Snapshot | Remove a specific snapshot |
snapback.deleteOlderSnapshots | Delete Older Snapshots | Clean up old snapshots |
snapback.showQuickPicker | Show Snapshot Picker | Quick picker for snapshot selection |
snapback.quickRestore | Quick Restore | Fast restore with picker |
snapback.refreshSnapshots | Refresh Snapshots | Update snapshot list |
Protection Commands
| Command | Title | Description |
|---|---|---|
snapback.protectFile | Protect File | Add file to protection |
snapback.protectCurrentFile | Protect Current File | Protect the currently open file |
snapback.protectEntireRepo | Apply Protection Defaults | Apply default protection to workspace |
snapback.unprotectFile | Unprotect File | Remove protection from a file |
snapback.changeProtectionLevel | Change Protection Level | Modify protection level for a file |
snapback.setWatchLevel | Set Protection: Watch | Silent auto-snapshots (low friction) |
snapback.setWarnLevel | Set Protection: Warn | Notification before save |
snapback.setBlockLevel | Set Protection: Block | Required snapshot with note |
snapback.showAllProtectedFiles | Show All Protected Files | List all protected files |
snapback.createPolicyOverride | Create Policy Override | Create custom protection rules |
snapback.protection.workspace | Protect Workspace | Apply protection to entire workspace |
Protection Levels Explained:
- Watch (green): Silent snapshots on every save
- Warn (yellow): Confirmation prompt before save
- Block (red): Required note for audit trail
Session Commands
| Command | Title | Description |
|---|---|---|
snapback.session.restore | Restore Session | Restore all files from a session |
snapback.session.list | List Sessions | View all recorded sessions |
snapback.session.export | Export Session | Export session data |
snapback.showSessionBrowser | Browse Sessions | Interactive session browser |
snapback.showFullHistory | Show Full History | Complete snapshot history |
snapback.previewRestoreSession | Preview Restore Session | Preview before restoring |
snapback.restoreSession | Restore Session | Execute session restore |
snapback.confirmRestoreFromPreview | Confirm Restore | Confirm after preview |
MCP (AI Assistant) Commands
| Command | Title | Description |
|---|---|---|
snapback.mcp.configure | Configure AI Assistants | Set up MCP for Cursor/Claude/Windsurf |
snapback.mcp.check | Run Code Check | Run validation on code |
snapback.mcp.checkPatterns | Check Code Patterns | Analyze code for patterns |
snapback.mcp.startTask | Start Development Task | Begin a tracked task |
snapback.mcp.endTask | End Development Task | Complete current task |
snapback.mcp.status | Show AI Assistant Status | View MCP connection status |
snapback.mcp.diagnose | Diagnose MCP Connection | Debug MCP issues |
snapback.mcp.reconnect | Force MCP Reconnection | Manually reconnect to daemon |
snapback.mcp.reset | Reset MCP Configuration | Reset MCP state |
snapback.mcp.disable | Disable SnapBack for AI | Turn off MCP integration |
snapback.mcp.validate | Validate MCP Configurations | Check MCP setup |
snapback.mcp.repair | Repair MCP Configurations | Fix MCP issues |
MCP enables AI assistants like Cursor, Claude Code, and Windsurf to interact with SnapBack for intelligent protection.
Dashboard & UI Commands
| Command | Title | Description |
|---|---|---|
snapback.openDashboard | Open Dashboard | Main SnapBack dashboard |
snapback.openVitalsDashboard | Open Vitals Dashboard | Performance and health metrics |
snapback.showStatus | Show Protection Status | Current protection state |
snapback.refreshViews | Refresh Views | Update all SnapBack views |
snapback.refreshTree | Refresh Explorer | Update file explorer |
snapback.toggleVitalsDisplay | Toggle Vitals in Status Bar | Show/hide vitals |
snapback.refreshVitals | Refresh Vitals Data | Update metrics |
snapback.openDashboard.activity | Dashboard: Activity | Activity tab |
snapback.openDashboard.settings | Dashboard: Settings | Settings tab |
snapback.openDashboard.vitals | Dashboard: Vitals | Vitals tab |
snapback.openDashboard.setup | Dashboard: Setup | Setup tab |
Configuration & Settings Commands
| Command | Title | Description |
|---|---|---|
snapback.updateConfiguration | Update Configuration | Modify settings |
snapback.toggleOfflineMode | Toggle Offline Mode | Enable/disable offline |
snapback.resetNotificationPreferences | Reset Notifications | Reset notification settings |
snapback.signIn | Sign In | Authenticate with SnapBack |
snapback.signOut | Sign Out | Log out of SnapBack |
snapback.connect | Connect Account | Link your account |
snapback.showAuthStatus | Show Auth Status | View authentication state |
snapback.initialize | Initialize | Set up SnapBack |
snapback.openOnboarding | Open Setup Wizard | Guided setup |
snapback.openWalkthrough | Show Welcome Guide | Interactive tutorial |
snapback.openDocumentation | Open Documentation | Open docs in browser |
snapback.setApiKey | Set API Key | Securely store API key |
snapback.migrateSecureConfig | Migrate to Secure Storage | Move keys to secure store |
AI Monitoring Commands
| Command | Title | Description |
|---|---|---|
snapback.toggleAIMonitoring | Toggle AI Monitoring | Enable/disable AI detection |
snapback.showAIMonitoringStatus | Show AI Status | View current AI detection state |
snapback.ai.injectRules | Inject AI Agent Rules | Add SnapBack rules to AI configs |
snapback.ai.resetRulesConfig | Reset Agent Rules | Reset AI rule configurations |
snapback.detectLanguageModels | Detect Language Models | Find available AI models |
File Health Commands
| Command | Title | Description |
|---|---|---|
snapback.showFileHealthStatus | Show File Health | View health metrics for current file |
snapback.refreshFileHealthDecorations | Refresh Health Decorations | Update health indicators |
snapback.clearFileHealthDecorations | Clear Health Decorations | Remove health indicators |
Internal Commands
| Command | Title | Description |
|---|---|---|
snapback.pioneer.login | Pioneer: Login | Internal program authentication |
snapback.pioneer.logout | Pioneer: Logout | Internal program sign-out |
Configuration Options
SnapBack can be configured via VS Code settings (Cmd+, or Ctrl+,):
| Setting | Type | Default | Description |
|---|---|---|---|
snapback.aiDetection.enabled | boolean | true | Enable AI-generated code detection |
snapback.showAutoSnapshotNotifications | boolean | true | Show notifications on auto-snapshots |
snapback.guardian.enabled | boolean | true | Enable risky pattern detection |
snapback.mcp.enabled | boolean | true | Enable MCP integration |
snapback.mcp.autoEnable | boolean | true | Auto-configure MCP for AI tools |
snapback.mcp.serverUrl | string | https://snapback-mcp.fly.dev | MCP server URL |
snapback.offlineMode.enabled | boolean | false | Disable all network requests |
snapback.ui.showTreeView | boolean | false | Show sidebar tree view |
snapback.ui.hideInternalFiles | boolean | true | Hide .snapback/ in explorer |
snapback.logLevel | string | info | Log verbosity level |
Log Levels
silent- No loggingerror- Errors onlywarn- Warnings and errorsinfo- General information (default)debug- Verbose debuggingtrace- Maximum detail
Context Menu Actions
SnapBack adds commands to the VS Code context menus:
File Explorer Context Menu
- Create Snapshot
- SnapBack (Restore)
- Protect File / Change Protection Level
- Unprotect File
- Compare with Snapshot
- Create Policy Override
Editor Context Menu
- Protect File / Change Protection Level
- Unprotect File
- Create Snapshot
- Create Policy Override
- Toggle Offline Mode
Related Documentation
- Quick Start Guide - Get started with SnapBack
- How Protection Works - AutoDecisionEngine details
- CLI Reference - Command-line interface
- MCP Integration - AI assistant integration
- Troubleshooting - Common issues and solutions