Installation

Build and activate the same version on every peer and on the SSH hub host.

Code Folder Sync is currently installed from a trusted checkout. The installer copies a versioned build and activates a small wrapper in your user-local bin directory.

Requirements

Linux x86-64 or macOS arm64.
Node.js 22 or newer.
Git.
SSH key access when the hub is on another machine.
Direct-child repositories with in-tree .git directories.

No root access, account, signup, token, or browser callback is required.

Build and install

Terminal

git clone https://github.com/MDerman/codefoldersync.git
cd codefoldersync
corepack pnpm install
pnpm check
pnpm build
node dist/product-cli.js install
~/.local/bin/codefoldersync --version

Install the same build on the hub machine before configuring an SSH hub. The remote command defaults to ~/.local/bin/codefoldersync.

Versions and rollback

Each build is stored under ~/.local/lib/codefoldersync/<version>/. Activation changes atomically, and an existing version is never overwritten in place.

Terminal

codefoldersync upgrade
codefoldersync rollback --version 0.2.0

Service support

Setup can create one user service per folder: a launchd label on macOS or a systemd user unit on Linux. Definitions use absolute executable, configuration, working-directory, and log paths, so they do not depend on an interactive shell.

codefoldersync service installGenerate and activate the per-folder service.

codefoldersync service statusInspect the exact configured service.

codefoldersync service logsPrint the service log locations.

codefoldersync service uninstallRemove only the service, never synchronized data.