1. Install & Setup
Run the installer. It will set up the binary, then runsinc --setup to configure your VPS, SSH keys, and sync.
Mac / Linux:
2. Connect
Navigate to any project on your machine and runsinc.
- Created
~/workspace/awesome-appon your VPS. - Synced your files instantly.
- Connected via SSH.
- Started an AI agent in a persistent tmux session.
3. Workflow
- Edit code locally: use your favorite editor or tool on your own files.
- Run commands remotely:
sincdrops you into a remote shell where your agent is running. - Detach: press
Ctrl+B, thenD. The session stays alive. - Resume: type
sinc -rlater to pick up exactly where you left off.
Commands Cheat Sheet
| Command | Action |
|---|---|
sinc | Connect (or create) session for current folder |
sinc -r | Resume existing session |
sinc push | Force local -> remote sync (asks for confirmation) |
sinc pull | Force remote -> local sync (asks for confirmation) |
sinc --list | Show all active sessions |
sinc -l | Short alias for list |
sinc --kill <id> | Stop sync and kill remote session |
sinc -k <id> | Short alias for kill |
sinc kill <id> | Subcommand alias for kill |
sinc --setup | Re-run configuration wizard |
Next Steps
- Installation Guide - Detailed install & dependencies.
- VPS Setup - How to prepare your server.
- Configuration - Customize ignores, paths, and agents.
- Architecture - How it works under the hood.