ods

Two-way OneDrive sync for code folders, built on rclone bisync + git. One small native Rust binary: engine, CLI, management GUI, and system tray.

rclone and git do the real work as subprocesses; ods orchestrates: discovers projects, generates per-repo filters, runs bisync with a delete-brake and a git health check, and surfaces state in a native window + tray.

Install (no build)

Prebuilt Windows binaries ship on every Release. To install the latest and register the scheduled sync + tray — no clone, no toolchain:

irm https://raw.githubusercontent.com/AlonRR/onedrive-sync/main/scripts/get.ps1 | iex

Or, from a clone, install prebuilt binaries instead of building:

scripts\install.ps1 -FromRelease          # latest release
scripts\install.ps1 -Version v0.2.0        # a specific release

Either way ods.exe + ods-gui.exe land in %LOCALAPPDATA%\ods, that dir is added to your per-user PATH (so ods <cmd> works from any terminal — open a new one after installing), the tray starts, the ods-sync (logon + every 30 min) and ods-tray (logon) tasks are registered, and a Start Menu shortcut + a Settings > Apps > Installed apps entry are created (both per-user, no elevation).

rclone + git are required at runtime; the installer preflights them and, if either is missing, offers to install it via winget — prompting first, or auto-approving with -YesDeps for non-interactive installs (-SkipDeps skips the check). Downloaded release binaries are verified against their published SHA256 before anything runs.

Already installed? ods update pulls the latest release and re-installs in place.

Two different ways to remove it, for two different purposes:

• scripts\uninstall.ps1 — rolls back to the old PowerShell tool (re-enables its scheduled tasks); leaves the ods binaries in place.
• ods uninstall, or Settings > Apps > Installed apps > ods > Uninstall — fully removes ods: scheduled tasks, Start Menu shortcut, Installed Apps entry, the PATH entry, and %LOCALAPPDATA%\ods itself.

Cutting a release: .github/workflows/release.yml builds the binaries and publishes a Release on any v*.*.* tag — git tag v0.2.0 && git push origin v0.2.0. (Publish to winget afterward with wingetcreate against the new release assets, if desired.)

Build from source

cargo build --release      # -> target/release/ods.exe (~10 MB, self-contained)

Requires the Rust toolchain (MSVC), and rclone + git on the machine.

Use

ods list                 # projects + per-machine status (+ conflict flags)
ods status               # last-run summary, recent errors, needs-attention set
ods sync                 # the full run (all active projects)
ods sync <id>            # one project (partial id ok)
ods sync --dry-run       # preview, changes nothing
ods sync --approve-deletes   # raise the delete-brake to 100% for this run
ods resync [id]          # force a fresh bisync baseline (one project, or all active)
ods pull <id>            # activate + sync a project here (revives a tombstone)
ods unmap <id> [--delete-local]   # stop syncing here; keep the OneDrive copy
ods forget <id>          # retire globally (tombstone); reversible with pull
ods add-watch <local> <dest>      # map a local folder to an arbitrary OneDrive dest
ods restore <id> [--file F] [--at T]   # restore from the local version archive
ods conflicts            # list unresolved conflict files
ods clean <id> [--yes]   # delete filtered files (e.g. node_modules) from OneDrive
ods discover             # interactively choose which available projects to sync
ods pause | ods resume   # pause/resume the scheduled sync (flag file)
ods filter <id>          # print the generated rclone filter (for validation)
ods diag                 # write a diagnostic bundle to %TEMP%
ods gui                  # management window + tray
ods update               # pull the latest release and re-install in place
ods uninstall            # remove tasks, shortcut, Installed Apps entry, PATH entry, and the install dir

Layout

module	role
paths / config / state	machine paths + path guards, TOML config, machine-state.json + the shared catalog (with conflict-copy merge)
jsonio	BOM-tolerant reads, atomic no-BOM writes, break-stale file locks (PowerShell-interop on-disk contract)
discovery	find mirror / watch / plain projects (both OneDrive and local sides)
filter	git-aware rclone filter generation
git	ls-files, gitignore listing, fsck health check
engine	bisync orchestration (filter, compare-mode, delete-brake, watchdog, per-project lock) + gate / seed / baseline
conflicts	conflict-file scan + git-divergence reconcile
prune	version-archive pruning (age + size, keeps each project's newest run)
run	the scheduled run: lock, reconcile, classify, per-project sync, retry, summary
actions	shared mutations: pull / unmap / forget / add-watch / resync / restore / pause / resume
events	JSONL event log + sync.log
gui	egui management window + tray

See CHANGELOG.md for what shipped in each release, and MIGRATION.md for the Rust-port parity validation record.

---

Parts of this repository were drafted with the help of an LLM agent; reviewed and verified locally.