Documentation menu

Code Folder Sync documentation

Install, configure, understand, and safely operate a self-hosted folder sync across trusted machines.

Code Folder Sync keeps one parent folder of explicitly enrolled Git repositories synchronized across your machines. It carries ordinary worktree files incrementally and treats each repository's .gitdirectory as one validated, recoverable transaction.

In five minutes

Build and install
corepack pnpm install
pnpm check
pnpm build
node dist/product-cli.js install
~/.local/bin/codefoldersync setup

The wizard creates or joins a folder, probes the filesystem, performs the initial synchronization, and can install the per-folder user service. Start with Installation for requirements or go directly to Getting started.

Guides

Supported scope

Version 2 synchronizes direct-child repositories inside one parent folder. Each repository needs an in-tree .git directory. Nested repositories, submodules with separate Git directories, linked worktrees, sockets, devices, and FIFOs are outside the current model.