Arivaran / AI Developer Toolkit

AI worktrees without repo sprawl

Give every coding agent an isolated branch workspace while unchanged files stay shared for disk and page-cache efficiency.

Install Arivaran Git
curl -fsSL https://get.arivaran.ai/aagit/stable/latest/install.sh | sudo bash -s -- --download
Linux · ext4macOS · APFSBetaWindows · NTFSBeta

Plain git

Copied12.2s
git clone repo.git
git worktree add ../feature-a
git worktree add ../feature-b
$EDITOR ../feature-a/app.ts

Working tree ready

The agent blocks until it finishes.

Agent working
Copied up frontThe whole tree
Disk used810 MB

Every agent pays for a full copy before it can start.

Arivaran Git

Lazy
Ready1.1s
git clone repo.git
git worktree add ../feature-a
git worktree add ../feature-b
$EDITOR ../feature-a/app.ts

Working tree ready

Hydrates on access, converges in the background.

ext4 · non-CoW fs

Agent working
Copied up frontPlaceholders
Disk used~284 MB

Editing breaks out one file. The rest stay shared, so disk and cache stay flat.

Illustrative of the lazy-vs-copy behavior on a measured 16,197-file, 270 MB repo (#10862): plain git copies the whole tree on clone and every worktree add, so it blocks for seconds and adds a full 270 MB per worktree; Arivaran Git lays placeholders and returns in about a second, adds about 7 MB per worktree, and shares one copy in page cache. Reads are byte-correct from the object store while files hydrate. Linux and ext4 today; macOS and Windows in beta.

How MOWI works

The working tree starts light, then becomes real exactly where it is touched.

MOWI is the safety layer behind Arivaran Git worktrees: it avoids up-front copies, serves correct bytes on demand, and breaks shared files away before writes can cross branches.

01

Placeholders first

Clone and worktree creation lay a correct directory shape immediately instead of copying every tracked byte before an agent can start.

02

Hydrate on access

Reads fetch byte-correct content from the git object store while background convergence links unchanged files back to the shared copy.

03

Break on write

Write intent moves that path to a private inode before mutation, so one agent can edit without changing another agent's worktree.

Benchmarks

Measured disk and cache wins, with the wall clock shown honestly.

The headline benchmark uses microsoft/vscode at 5f595aed: 16,197 working-tree files, about 270 MB, measured on AlmaLinux 10 with both XFS and ext4.

Methodology #10862
Arivaran Git worktree benchmark table
FilesystemCoW classPlain gitArivaran GitPage cache after warming source
XFS on LinuxReflink-capable filesystem
270 MB2.81 s wall time
6.8 MB3.27 s wall time
255 MB already hot through shared inodes
ext4 on LinuxNon-CoW filesystem
274 MB1.96 s wall time
18.6 MB1.79 s wall time
255 MB already hot through shared inodes

All numbers in this table come from #10862: incremental disk is the df delta, the source tree was warmed before cache measurement, and aagit linked 16,195 of 16,197 files with 3 checkout fallbacks.

Platform support

Linux is GA; macOS and Windows are beta.

The same product model spans different filesystem classes. The page names the class because copy-on-write behavior changes by OS and storage layer.

Linux

GA

ext4 non-CoW, XFS reflink-capable

GA path with fanotify break-on-write and the measured #10862 benchmark surface.

macOS

Beta

APFS CoW

Beta path using APFS copy-on-write today, with deeper EndpointSecurity coverage gated separately.

Windows

Beta

NTFS non-CoW

Beta path with user-mode write coverage and an enterprise minifilter track behind signing gates.

Quickstart

Install, verify, then give an agent a branch.

The bootstrap installer is the persistent full-stack path. The commands are ordinary shell commands and can be copied independently.

1Install
curl -fsSL https://get.arivaran.ai/aagit/stable/latest/install.sh | sudo bash -s -- --download
2Verify
aagit doctor
3Add worktree
aagit worktree add ../agent-auth main

Package-manager path: npm install -g @arivaran/aagit && aagit setup. The npm package ships as a thin launcher with per-platform optional dependencies and no postinstall script.

FAQ

What teams ask before turning it on.

The product is transparent to git for normal commands, but the operational questions are about agents, monorepos, write safety, and clean removal.

Does every agent need a special integration?

No. Arivaran Git is a thin git wrapper. Agents can keep running normal git-shaped workflows, while aagit accelerates clone and worktree creation and passes unrelated commands through.

Is this only for very large monorepos?

No. The disk and page-cache win appears whenever teams create several sibling worktrees. Larger or byte-heavy repos benefit more on wall time; source-heavy repos still benefit on storage and cache.

How do shared files avoid cross-branch corruption?

Shared files are protected by write-intent handling. Before a shared path is modified, Arivaran Git materializes a private inode for that worktree, so the sibling remains unchanged.

What happens when we uninstall?

Run hydrate before removal, or let the uninstaller hydrate configured scopes. Lazy files become real bytes and hardlinks are broken into independent files so the checkout remains plain git.