cloudrsync sync Β· v1

Install cloudrsync

A folder appears on your desktop. Drop files in β€” they sync to your workspace and S3 bucket in seconds.

Install via npm (devs)

$ npm install -g @codrsync/cli

Auto-update: npm update -g @codrsync/cli

or install with pip
Install via:
01

Run the installer

Double-click the downloaded file to launch the native installer wizard.

$codrsync --version
# Double-click codrsync-mac-arm64.pkg (or codrsync-mac-x64.pkg)
# The wizard installs codrsync to /usr/local/bin automatically

Signed and notarized β€” no 'unidentified developer' prompt. Gatekeeper accepts it directly.

02

Authenticate

Connect to your codrsync account. Opens a browser window for one-click login.

$codrsync auth --cloud
03

Install sync for your workspace

Replace anorak with your workspace slug. The sync folder is created and registered as a background service automatically.

$codrsync sync install anorak
# β†’ Registers launchd service
# β†’ Adds ~/codrsync/anorak/ to Finder sidebar
# β†’ Starts tray icon
βœ…

You're all set

The herald is running in background. Drop any file into ~/codrsync/anorak/ and it'll appear in your workspace in under 3 seconds.

Check status anytime:

$ codrsync sync status
☁️

Tray icon included

Built-in

The binary already bundles the tray icon (no extra install needed). A menubar icon appears automatically after codrsync sync install β€” blue while syncing, grey when idle.

System requirements

🍎macOSyours

macOS 11 Big Sur or later Β· Python 3.9+

🐧Linux

Ubuntu 20.04 / Debian 11 / any systemd distro Β· Python 3.9+

πŸͺŸWindows

Windows 10 / 11 Β· Python 3.9+ Β· PowerShell 5+

All platforms: codrsync account (free) Β· internet connection Β· workspace created at codrsync.dev

Diagnose issues

$ codrsync sync doctor

Checks authentication, service status, inotify limits (Linux), watchdog dependency, and API connectivity. Prints a checklist with fix instructions.