syncz 0.1.3

Zero-config file sync between local and remote machines using rsync + ssh
syncz-0.1.3 is not a library.

Features

  • Smart Path Mapping — ~/projects/foo syncs to ~/projects/foo on remote, regardless of different home paths
  • Zero Config — Just run it. No config files needed
  • Bi-directional (Default) — Automatically syncs both ways (Newer Wins)
  • Uni-directional — Explicitly push with --push or pull with --pull
  • Dry-run Preview — See a tree-style diff before syncing
  • SSH Host Picker — Fuzzy-select hosts from ~/.ssh/config
  • Progress Display — Real-time transfer progress with summary stats
  • Sensible Defaults — Auto-excludes .git/, node_modules/, target/, .DS_Store

Installation

cargo install syncz

Requires rsync and ssh in your PATH.

Quick Start

# Sync both ways (default)
syncz ~/projects/my-app my-server

# Push only
syncz --push ~/projects/my-app my-server

# Pull only
syncz --pull ~/projects/my-app my-server

# Preview changes first
syncz -d ~/projects/my-app my-server

# No host? Get a fuzzy picker
syncz ~/projects/my-app

Usage

syncz [OPTIONS] <PATH> [HOST]
Option Description
--push Push from local to remote (disables bidirectional)
--pull Pull from remote to local (disables bidirectional)
-d, --dry-run Preview changes with tree diff
--no-perms Skip permission sync (useful for macOS/Linux)

How It Works

  1. Path Mapping — Translates local paths to remote equivalents relative to ~
  2. Auto mkdir — Creates missing parent directories on the remote
  3. SSH Multiplexing — Reuses connections via ControlMaster for speed
  4. Delta Transfer — Only syncs what's changed

License

MIT