Installation

treesync ships as a single binary that includes both the CLI and the background sync daemon. Install it, then head to Getting started.

Supported platforms

Platform	Status
macOS (Apple Silicon & Intel)	✅ Supported
Linux (x86-64 & arm64)	✅ Supported
Windows	🚧 Coming later

You’ll also want git installed if you sync repositories — treesync mirrors each repo’s .git as plain files, but you’ll use git to work with the synced repos.

Install

curl | sh

The quickest way on macOS & Linux:


curl -fsSL https://treesync.dev/install.sh | sh

This downloads the right binary for your OS and architecture, installs it on your PATH, and registers the background daemon.

Homebrew

macOS & Linux via Homebrew :


brew install treesync/tap/treesync

apt / deb

Debian / Ubuntu — add the apt repository once, then install:


# Add the treesync apt repository (one-time)
curl -fsSL https://treesync.dev/apt/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/treesync.gpg
echo "deb [signed-by=/usr/share/keyrings/treesync.gpg] https://treesync.dev/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/treesync.list
 
sudo apt update
sudo apt install treesync

A .deb package is also available from the downloads page if you prefer to install it directly.

Verify the install


treesync version

You should see the installed version printed.

Next: Getting started — sign in, add your code folder, and run your first sync.

Upgrading

Installed with	Upgrade with
Quick install (`curl \| sh`)	`treesync update` (or re-run the install script)
Homebrew	`brew upgrade treesync`
apt	`sudo apt update && sudo apt install --only-upgrade treesync`

treesync update fetches the latest release and replaces the binary in place; the daemon restarts automatically on the new version.

Uninstall

Stopping treesync leaves the files already on your disk exactly where they are — uninstalling only removes the program, not your synced folders.


treesync logout          # sign this device out (optional)

Then remove the binary the same way you installed it:

Installed with	Uninstall with
Quick install (`curl \| sh`)	`curl -fsSL https://treesync.dev/uninstall.sh \| sh`
Homebrew	`brew uninstall treesync`
apt	`sudo apt remove treesync`

To also delete treesync’s local settings and state, remove its config directory:


rm -rf ~/.treesync

See Configuration for what lives in ~/.treesync.