Developer FAQ

Frequently Asked Questions

Everything you need to know about Vibe Backup, safe rollbacks, and workflow integration.

#General & Workflow

Does Vibe Backup replace Git?

No, Vibe Backup is designed to complement Git, not replace it. Git is for milestone commits and team collaboration. Vibe Backup is your personal high-frequency flight recorder between Git commits. When you are experimenting with AI or trying out risky refactors, you don't want to create 30 temporary Git branches or pollute your commit log with 'wip' commits. Vibe Backup gives you instant, zero-friction checkpoints.

How does Vibe Backup function as a Visual Git companion and a Git alternative?

Vibe Backup seamlessly combines two visual versioning tracks: 1. As a Visual Git Companion: When Git Commit Trigger is enabled, every 'git commit' you execute in your terminal or IDE is automatically captured into Vibe Backup's timeline with its commit message, SHA, and branch. You can visually browse commits, inspect line-by-line diffs, and restore to any commit with 1 click without dangerous 'git reset' commands. 2. As a Visual Git Alternative (Checkpoints & MCP): For high-frequency coding and AI prompts, Checkpoints provide a zero-ceremony alternative that works without 'git init', captures uncommitted dirty states in 300ms, and keeps your public Git history completely clean. Both Git commits and Checkpoints appear side-by-side in your macOS menu bar timeline with undoable restore protection.

How does it protect my code during Cursor, Claude, Codex, Devin, or Pi refactors?

Before you submit a complex prompt that might touch dozens of files, hit your global hotkey (⌘⌥B). Vibe Backup takes a compressed, encrypted snapshot in under 300ms. If the AI model hallucinates, deletes components, or breaks the build, open Vibe Backup from the macOS menu bar and click 'Roll Back'. Your project returns to its exact working state in seconds.

Why not just use 'git stash'?

Git stash requires switching to the terminal, doesn't capture untracked or new files unless you remember `--include-untracked`, and 'git stash pop' frequently creates messy merge conflicts. If a pop goes wrong, uncommitted changes can be lost permanently. Vibe Backup captures all project files in 0.3s without terminal commands and creates an automatic safety checkpoint before every rollback.

What platforms does Vibe Backup support?

Vibe Backup is a native macOS application built with Swift and SwiftUI. It supports macOS 13.5 (Ventura) through macOS 27 (Golden Gate). It is a Universal Binary running natively on Apple Silicon (M1/M2/M3/M4/M5/M6) and Intel Macs.

What is Vibe Backup MCP and how do AI coding tools use it?

Vibe Backup includes a built-in Model Context Protocol (MCP) server (vibebackup-mcp). It connects directly to AI tools like Claude Code, Cursor, Codex, Devin, Pi, Windsurf, and Zed via stdio JSON-RPC. AI agents can autonomously take snapshots before refactoring, inspect unified diffs, read historical files, and roll back safely without touching Git.

Is the MCP Server free, or does it require Pro?

The MCP server executable (vibebackup-mcp) is 100% free with zero license gate. It is a standalone Swift universal binary bundled directly with the app. You can use all 11 MCP tools across any number of projects without paying anything. Pro unlocks multi-target mirror backups, cloud sync, automated scheduling, and restoring older historical versions beyond the latest.

How does MCP require AI agents to create checkpoints before risky edits?

When an AI agent (Claude Code, Cursor, Codex, Devin, Windsurf, Zed, etc.) connects to Vibe Backup via MCP, Vibe Backup transmits strict system instructions during the initialization handshake. These protocol instructions mandate that the agent must: 1. Call create_checkpoint with an intent note BEFORE making any risky, destructive, or multi-file edits. 2. Call diff_checkpoints(newer='working_tree') after editing to self-review all changes. 3. If tests fail or the user wants to undo, call restore_checkpoint. Before any in-place restore executes, Vibe Backup automatically saves a pre-restore safety checkpoint first—making rollbacks themselves 100% undoable! This enforces an automatic flight recorder on every AI refactor without touching Git.

What is the key difference between Git and Vibe Backup MCP?

The core difference in one sentence: Git tracks committed history, while Vibe Backup tracks uncommitted state. During AI vibe coding, you don't want 30 messy 'wip' commits or stash conflicts polluting your Git repository. Vibe Backup works with zero side effects on .git, requires no git init, and creates an automatic safety checkpoint before every restore so you can undo rollbacks.

#Features & Architecture

Does it back up heavy folders like node_modules?

No! Vibe Backup has an intelligent exclude engine specifically built for developers. It automatically ignores node_modules, .git internals, .DS_Store, build artifacts (DerivedData, .next, dist, target), and temp logs. As a result, a 500MB codebase typically compresses down into a tiny 200KB archive.

How does the 'Safe Rollback' feature prevent data loss?

Before Vibe Backup restores older code over your current project directory, it performs an atomic safety check and automatically creates a fresh safety checkpoint of your active working directory. If you change your mind after rolling back, you can easily undo the restore.

How does Git commit auto-trigger work?

In Pro, Vibe Backup can monitor your active project repositories in the background. Every time you run 'git commit', it detects the new commit and automatically creates a snapshot, tagging your commit message directly into the backup description.

What cloud storage providers can I sync with?

Cloud Sync is a Pro feature. Vibe Backup natively supports direct sync to iCloud Drive, Google Drive, Dropbox, and OneDrive. All archives can be encrypted with AES-256 before uploading to keep your off-site copies secure.

What storage modes does Vibe Backup support?

Vibe Backup natively supports two storage modes: 1. Snapshot Store (default for new projects): uses content-addressed deduplication and Apple LZFSE compression. It saves only files that changed since the last backup while sharing unchanged files across snapshots, keeping disk usage tiny (+KB deltas) while allowing every snapshot to restore independently. 2. ZIP Archive: saves every backup as a self-contained, standalone .zip file that can be extracted anywhere on any machine without special software.

What are Backup Locations and how do Multi-Target Mirror backups work?

Backup Locations allow you to configure reusable backup destinations once (such as your internal drive, an external SSD, or a network NAS). When adding a project, simply select a location without picking folder paths each time. You can also enable Multi-Target Mirror Backups to simultaneously back up to both a primary fast drive and an external mirror destination for robust 3-2-1 local redundancy.

Can I back up directly to a NAS or network shared folder?

Yes! Vibe Backup natively supports Network Volume locations over SMB, NFS, AFP, and WebDAV via macOS NetFS. It automatically mounts network shares in the background when running backups and securely stores passwords inside the macOS Keychain.

#Security & Privacy

Does my source code ever leave my Mac?

Never without your explicit configuration. Vibe Backup is 100% local by default. We do not have servers that ingest your code, and we do not run analytics or telemetry on your files. If you enable Cloud Sync, files transfer directly between your Mac and your chosen cloud provider (like your personal iCloud or Google Drive) using OAuth or official APIs.

How is encryption handled?

You can enable AES-256 encryption for any project archive. Encryption passwords are never stored in plain text; they are secured directly inside your macOS system Keychain.

What is the difference between Free and Pro?

The free version stays fully usable: 3 projects, unlimited manual backups, and restore of the latest version. Upgrade to Pro Lifetime ($14.99, limited-time offer from $29.99) to unlock unlimited projects, restore any version in the backup history, Cloud Sync (iCloud Drive, Dropbox, Google Drive, OneDrive), automatic backups on a schedule or after every Git commit, priority support, and all future updates.

Ready to give AI prompts an undo button?

Download the free version and experience instant 300ms backups today.