Theo-brainUnofficial. Not affiliated with Theo or t3.gg.
Sign inYou

T3 Code guide

Fast worktree checkout on macOS

Source control and worktrees

A worktree is a separate copy of your project's files so agents can work without clashing.

A Labs beta that keeps a few recent checkouts of each repository in a cache. New worktrees are cloned from that cache with APFS copy-on-write, which is about twice as fast as a normal checkout.

T3 Code docs: project settings

What it’s for

Creating worktrees faster on a Mac, and getting a fast first git status in them.

T3 Code docs: project settings

When to use it

When you create many worktrees of the same repository on a Mac with Git 2.42 or newer.

T3 Code docs: project settings

How to use it

  1. On each Mac, turn on Settings → Labs → Fast worktree checkout.

    T3 Code docs: project settings

  2. Expect the first worktree of a repository to use a normal checkout while it fills the cache.

    T3 Code docs: project settings

  3. Sparse checkouts, Git LFS repositories and worktrees on another drive still use a normal checkout. Turning the feature off deletes the cache.

    T3 Code docs: project settings

What’s changed

  • Labs beta option opens new worktree threads faster on macOS.Added Nov 9

Related settings

Unofficial notes. Not affiliated with Theo or t3.gg.