Clone from snapshot (#582)

* Clone from snapshot

* Update cloud.mdx

* Split new step

* Update clone-repo.ts

* Update v6.mdx

* Misc fixes

* Update create-sandbox.ts

* Update configure-git.ts

* Update clone-repo.ts

Author: haydenbleasel

apps/app/app/api/cron/lint/lint-repo.ts

@@ -7,6 +7,7 @@ import { configureGit } from "@/lib/steps/configure-git";
 import { createBranch } from "@/lib/steps/create-branch";
 import { createLintRun } from "@/lib/steps/create-lint-run";
 import { createPullRequest } from "@/lib/steps/create-pr";
+import { cloneRepo } from "@/lib/steps/clone-repo";
 import { createSandbox } from "@/lib/steps/create-sandbox";
 import { extendSandbox } from "@/lib/steps/extend-sandbox";
 import { fixLint } from "@/lib/steps/fix-lint";
@@ -74,12 +75,14 @@ export async function lintRepoWorkflow(params: LintRepoParams): Promise<void> {
   // Get GitHub access token
   const token = await getGitHubToken(installationId);
 
-  // Create sandbox with the repo (returns sandbox ID for serialization)
-  const sandboxId = await createSandbox(repoFullName, token);
+  // Create sandbox (returns sandbox ID for serialization)
+  const sandboxId = await createSandbox();
 
   let result: LintStepResult;
 
   try {
+    // Clone the repo into the sandbox
+    await cloneRepo(sandboxId, repoFullName, token);
     // Install dependencies
     await installDependencies(sandboxId);
 

apps/app/app/api/github/webhooks/review-pr.ts

@@ -5,6 +5,7 @@ import { checkPushAccess } from "@/lib/steps/check-push-access";
 import { checkoutBranch } from "@/lib/steps/checkout-branch";
 import { commitAndPush } from "@/lib/steps/commit-and-push";
 import { configureGit } from "@/lib/steps/configure-git";
+import { cloneRepo } from "@/lib/steps/clone-repo";
 import { createSandbox } from "@/lib/steps/create-sandbox";
 import { extendSandbox } from "@/lib/steps/extend-sandbox";
 import { fixLint } from "@/lib/steps/fix-lint";
@@ -81,10 +82,12 @@ Please ensure the Ultracite app has write access to this repository and branch.
   // Get GitHub access token
   const token = await getGitHubToken(installationId);
 
-  // Create sandbox with the repo (returns sandbox ID for serialization)
-  const sandboxId = await createSandbox(repoFullName, token);
+  // Create sandbox (returns sandbox ID for serialization)
+  const sandboxId = await createSandbox();
 
   try {
+    // Clone the repo into the sandbox
+    await cloneRepo(sandboxId, repoFullName, token);
     // Checkout the PR branch
     await checkoutBranch(sandboxId, prBranch);
 

apps/app/lib/steps/clone-repo.ts

@@ -0,0 +1,40 @@
+import { Sandbox } from "@vercel/sandbox";
+import { parseError } from "@/lib/error";
+
+export async function cloneRepo(
+  sandboxId: string,
+  repoFullName: string,
+  token: string
+): Promise<void> {
+  "use step";
+
+  let sandbox: Sandbox | null = null;
+
+  try {
+    sandbox = await Sandbox.get({ sandboxId });
+  } catch (error) {
+    throw new Error(
+      `[cloneRepo] Failed to get sandbox: ${parseError(error)}`
+    );
+  }
+
+  try {
+    const result = await sandbox.runCommand("git", [
+      "clone",
+      "--depth",
+      "1",
+      `https://x-access-token:${token}@github.com/${repoFullName}`,
+      ".",
+    ]);
+
+    if (result.exitCode !== 0) {
+      const output = await result.output("both");
+      const sanitized = output.replaceAll(token, "***");
+      throw new Error(
+        `git clone failed with exit code ${result.exitCode}: ${sanitized.trim()}`
+      );
+    }
+  } catch (error) {
+    throw new Error(`Failed to clone repo: ${parseError(error)}`);
+  }
+}

apps/app/lib/steps/configure-git.ts

@@ -18,10 +18,8 @@ export async function configureGit(
     );
   }
 
-  const name = "Ultracite";
-  const email = "ultracite@users.noreply.github.com";
-
-  // Configure remote URL with authentication token
+  // Git user.name, user.email, and core.hooksPath are pre-configured in the sandbox snapshot.
+  // The authenticated remote URL and local hooks override are per-run.
   const authenticatedUrl = `https://x-access-token:${token}@github.com/${repoFullName}.git`;
 
   try {
@@ -31,27 +29,16 @@ export async function configureGit(
       "origin",
       authenticatedUrl,
     ]);
-  } catch (error) {
-    throw new Error(`Failed to set remote URL: ${parseError(error)}`);
-  }
-
-  try {
-    await sandbox.runCommand("git", ["config", "user.email", email]);
-  } catch (error) {
-    throw new Error(`Failed to configure git email: ${parseError(error)}`);
-  }
 
-  try {
-    await sandbox.runCommand("git", ["config", "user.name", name]);
-  } catch (error) {
-    throw new Error(`Failed to configure git name: ${parseError(error)}`);
-  }
-
-  // Disable all git hooks in the sandbox to prevent TTY-dependent hooks
-  // (like prepare-commit-msg) from failing in non-interactive environments
-  try {
-    await sandbox.runCommand("git", ["config", "core.hooksPath", "/dev/null"]);
+    // Disable hooks locally to override any hooks installed by package managers
+    // (e.g. husky's prepare script sets core.hooksPath to .husky/)
+    await sandbox.runCommand("git", [
+      "config",
+      "--local",
+      "core.hooksPath",
+      "/dev/null",
+    ]);
   } catch (error) {
-    throw new Error(`Failed to disable git hooks: ${parseError(error)}`);
+    throw new Error(`Failed to configure git: ${parseError(error)}`);
   }
 }

apps/app/lib/steps/create-sandbox.ts

@@ -3,22 +3,16 @@ import { parseError } from "@/lib/error";
 
 const FIVE_MINUTES_MS = 5 * 60 * 1000;
 
-export async function createSandbox(
-  repoFullName: string,
-  token: string
-): Promise<string> {
+export async function createSandbox(): Promise<string> {
   "use step";
 
   let sandbox: Sandbox | null = null;
 
   try {
     sandbox = await Sandbox.create({
       source: {
-        type: "git",
-        url: `https://github.com/${repoFullName}`,
-        username: "x-access-token",
-        password: token,
-        depth: 1,
+        type: "snapshot",
+        snapshotId: "snap_C7bRk0eKocK3L8QqZsNIz54Cwwk7",
       },
       timeout: FIVE_MINUTES_MS,
     });

apps/app/lib/steps/install-dependencies.ts

@@ -14,49 +14,8 @@ export async function installDependencies(sandboxId: string): Promise<void> {
     );
   }
 
-  // Install ni and Claude Code separately so one failure doesn't block the other
-  for (const pkg of ["@antfu/ni", "@anthropic-ai/claude-code"]) {
-    const result = await sandbox
-      .runCommand("npm", ["install", "-g", pkg])
-      .catch((error: unknown) => {
-        throw new Error(`Failed to install ${pkg}: ${parseError(error)}`);
-      });
-
-    if (result.exitCode !== 0) {
-      const output = await result.output("both");
-      throw new Error(
-        `Failed to install ${pkg} (exit code ${result.exitCode}): ${output.trim()}`
-      );
-    }
-  }
-
-  // Detect the package manager using `ni -v`
-  const result = await sandbox
-    .runCommand("ni", ["-v"])
-    .catch((error: unknown) => {
-      throw new Error(`Failed to detect package manager: ${parseError(error)}`);
-    });
-
-  const output = await result.stdout();
-
-  // Parse output to find which package manager is used (pnpm, yarn, or bun)
-  const packageManagers = ["pnpm", "yarn", "bun"];
-  const detectedManager = packageManagers.find((pm) =>
-    output.split("\n").some((line) => line.startsWith(pm))
-  );
-
-  // Install the detected package manager if needed (npm is already available)
-  if (detectedManager) {
-    try {
-      await sandbox.runCommand("npm", ["install", "-g", detectedManager]);
-    } catch (error) {
-      throw new Error(
-        `Failed to install ${detectedManager}: ${parseError(error)}`
-      );
-    }
-  }
-
-  // Use `ni` to install project dependencies
+  // Global tools (ni, claude-code, package managers) are pre-installed
+  // in the sandbox snapshot. Only project dependencies need installing.
   try {
     await sandbox.runCommand("ni", []);
   } catch (error) {

apps/docs/cloud.mdx

@@ -60,6 +60,18 @@ In the dashboard, enable the repositories you want Ultracite to lint. Once enabl
 
 All linting and fixes run in isolated sandbox environments. Your code is cloned, processed, and the sandbox is destroyed — we never store your source code.
 
+The sandbox is created from a snapshot with a simple, pre-configured environment which helps saves a few precious seconds on each run.
+
+```sh
+# Global tools
+npm install -g @antfu/ni @anthropic-ai/claude-code pnpm yarn bun
+
+# Git config (global so it applies to all cloned repos)
+git config --global user.name "Ultracite"
+git config --global user.email "ultracite@users.noreply.github.com"
+git config --global core.hooksPath /dev/null
+```
+
 ### AI-Powered Fixes
 
 When `ultracite fix` can't auto-fix an issue, Ultracite uses Claude Code to understand the context and apply intelligent fixes. This handles complex issues like:

apps/docs/upgrade/v6.mdx

@@ -9,15 +9,15 @@ Ultracite v6 introduces framework-specific presets that give you more control ov
 
 v6 introduces [framework-specific presets](/configuration#framework-specific-configurations):
 
-- [`ultracite/core`](/preset/core) - Base JavaScript/TypeScript rules
-- [`ultracite/react`](/preset/react) - React-specific rules
-- [`ultracite/next`](/preset/next) - Next.js-specific rules
-- [`ultracite/solid`](/preset/solid) - Solid.js rules
-- [`ultracite/vue`](/preset/vue) - Vue.js rules
-- [`ultracite/svelte`](/preset/svelte) - Svelte rules
-- [`ultracite/qwik`](/preset/qwik) - Qwik rules
-- [`ultracite/angular`](/preset/angular) - Angular HTML parser
-- [`ultracite/remix`](/preset/remix) - File-based routing support
+- [`ultracite/core`](/configuration#framework-presets) - Base JavaScript/TypeScript rules
+- [`ultracite/react`](/configuration#framework-presets) - React-specific rules
+- [`ultracite/next`](/configuration#framework-presets) - Next.js-specific rules
+- [`ultracite/solid`](/configuration#framework-presets) - Solid.js rules
+- [`ultracite/vue`](/configuration#framework-presets) - Vue.js rules
+- [`ultracite/svelte`](/configuration#framework-presets) - Svelte rules
+- [`ultracite/qwik`](/configuration#framework-presets) - Qwik rules
+- [`ultracite/angular`](/configuration#framework-presets) - Angular HTML parser
+- [`ultracite/remix`](/configuration#framework-presets) - File-based routing support
 
 ## Migration