SnapDrive

Snapshot testing tool for iOS. Leverages AI Agents to autonomously operate iOS Simulator, automatically generating test scenarios and baselines. Adapts flexibly to UI changes, preventing test case decay.

Requirements

• macOS + Xcode
• Node.js 20+
• Python 3.x + fb-idb

Setup

1. Install fb-idb (Python)

pip install fb-idb

2. Configure Claude Desktop/Code

Add to .mcp.json:

{
  "mcpServers": {
    "snapdrive": {
      "command": "npx",
      "args": ["snapdrive-ios"]
    }
  }
}

With environment variables:

{
  "mcpServers": {
    "snapdrive": {
      "command": "npx",
      "args": ["snapdrive-ios"],
      "env": {
        "SNAPDRIVE_RESULTS_DIR": "/path/to/your/project/results",
        "SNAPDRIVE_LOG_LEVEL": "debug"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SNAPDRIVE_RESULTS_DIR | Results output directory | ./results | | SNAPDRIVE_LOG_LEVEL | Log level (debug/info/warn/error) | info |

Version Control

The .snapdrive directory should be committed to Git:

git add .snapdrive/
git commit -m "Add SnapDrive test cases and baselines"

This allows your team to share test scenarios and baselines, ensuring consistent visual regression testing across all environments.

Note: The results/ directory contains test execution outputs and should be added to .gitignore.

Documentation

• Usage Guide - Basic operations
• Test Cases - Creating and running structured tests
• CLI - Command-line tool usage
• Fastlane Integration - CI/CD with Fastlane
• MCP Tools Reference - Available tools reference

License

MIT