Command-line client

Run vsync <command> --help for the exact options supported by your installed version.

Common context

Most remote commands need a game and platform:

vsync --game hippo --platform win64 list

You can set VSYNC_GAME and VSYNC_PLATFORM instead.

Browse builds

vsync --game hippo --platform win64 list

The output includes streams and recent builds, including versions, authors, source revisions, broken status, pin status, and notes.

Fetch builds

Fetch the current tip of a stream:

vsync --game hippo --platform win64 fetch nightly

Fetch an exact version:

vsync --game hippo --platform win64 fetch --version 2193.1.2

Fetch an immutable build ID to an explicit directory:

vsync fetch 067c4e9949d5d77952ac78bfb1a823ab --out D:\builds\test

Without --out, Vsync creates a path below the configured build root.

Publish a build

vsync --game hippo --platform win64 commit D:\build-output \
  --stream nightly \
  --version 2193.1.2 \
  --rev CL45210 \
  --config development

The final line is the immutable build ID. Recommitting identical contents produces the same ID and uploads no duplicate chunks.

Manage streams

vsync --game hippo --platform win64 stream set nightly <build-id>
vsync --game hippo stream describe nightly "Latest automated build"
vsync --game hippo --platform win64 stream rm nightly

Removing a stream removes its pointer and history. It does not immediately delete build data; normal retention and garbage collection rules apply.

Flag and pin builds

vsync flag <build-id> --broken --note "Crashes during startup"
vsync flag <build-id> --ok
vsync pin <build-id>
vsync pin <build-id> --remove

Pinned builds are protected from server garbage collection.

Sign out

vsync logout

This forgets the login only. It does not remove cached chunks or checkouts.