CLI

​

Usage

sinc [options] [command]

​

Core Commands

​

sinc (Connect)

• Checks if a session exists for the current directory.
• If yes, attaches to it (if -r is implied or auto-detected).
• If no, creates a new sync session and new tmux session.
• Behavior: Syncs local files -> Remote, then drops you into the remote shell.

​

sinc -r / sinc --resume

• Only tries to attach to an existing session.
• Fails if no session exists for the current directory.
• Use this when you know you have a session running and want to jump back in.

​

sinc --setup

• Interactive prompt to set up config.json.
• Checks and installs dependencies (mutagen).
• Can trigger the VPS bootstrap script.

​

sinc --list / sinc -l / sinc list

• Lists all active sincronizado sessions.
• Shows: Session Name, Local Path, Remote Path, Sync Status.

​

sinc push

• Forces local files to overwrite the remote side of the current session.
• Requires an active session for the current directory.
• Shows an overwrite summary and asks for confirmation unless --yes is provided.

​

sinc pull

• Forces remote files to overwrite the local side of the current session.
• Requires an active session for the current directory.
• Shows an overwrite summary and asks for confirmation unless --yes is provided.

​

sinc --kill <session_name> / sinc -k <session_name> / sinc kill <session_name>

• Terminates the Mutagen sync session.
• Kills the remote tmux session.
• Does NOT delete the files on the VPS.

​

sinc --uninstall

• Removes ~/.config/sincronizado.
• Stops the sync session for the current project.
• Useful if you want to reset everything on your machine.

​

Flags

​

JSON Output

{
  "event": "sync-status",
  "session": "sinc-myapp-7f8a9d",
  "exists": true,
  "status": "Watching for changes",
  "watching": true
}

[
  {
    "name": "sinc-myapp-7f8a9d",
    "sync": {
      "exists": true,
      "status": "Watching for changes",
      "conflicts": []
    }
  }
]

​

Exit Codes

• 0: Success
• 1: Generic Error
• 2: Usage Error (invalid flags)
• 69: Dependency Missing (Mutagen not found)
• 76: Connection Error (SSH failed)
• 78: Config Error (Invalid JSON or missing fields)