# sftp-autosync

> Valet-style SFTP auto-sync for macOS. Park a parent folder; every child project with a sync config is watched and uploaded over OpenSSH ControlMaster.

## Product

- [Homepage](https://sftp-autosync-web.pages.dev/)
- [Homepage (Markdown)](https://sftp-autosync-web.pages.dev/index.md)
- [GitHub repository](https://github.com/ahp-sooyaa/sftp-autosync)
- [Agent skill](https://sftp-autosync-web.pages.dev/.well-known/agent-skills/sftp-autosync/SKILL.md)

## Install

```bash
bun install -g sftp-autosync
# or: npm install -g sftp-autosync
# or: brew tap ahp-sooyaa/sftp-autosync && brew install --HEAD sftp-autosync
```

## Quick start

1. `sftp-autosync init` — park ~/Sites, global config, optional launchd
2. `cd ~/Sites/my-project && sftp-autosync setup` — project sync config
3. `sftp-autosync start` — foreground watcher (or launchd from init)

## Key features

- OpenSSH ControlMaster: one tunnel per host/user/key across projects
- Zero package dependencies: ships as a small Bun/Node CLI
- SHA-256 content fingerprints: skip unchanged bytes on save
- Split folder routing: longest local prefix wins
- launchd daemon at login (optional from init)
- macOS notifications on failure and optional slow/success alerts