Skip to main content
Three command-line tools, all of them installable and runnable on your own infrastructure without involving us. They share credentials, so one login covers all three.
Each tool ships an AGENTS.md beside the binary — the operating guide, written for a coding agent to read top-down and act on. It is the same content as the “Agent workflow” page linked above, so an agent with a download and no web access still has it. If you are pointing an agent at one of these tools, that is the file to give it.

​
Install

Every release publishes archives for macOS and Linux on both amd64 and arm64 (synqcli also builds for Windows), plus a checksums.txt. Pick a version from the releases page — the archive filename carries it, so it has to be named explicitly.
On Windows, download the .zip for your architecture from the releases page and put synqcli.exe on your PATH.
Verify a download against the checksums published with the release:
On macOS a downloaded binary may be quarantined. If it refuses to start, xattr -d com.apple.quarantine /usr/local/bin/<tool> clears the flag.

​
Sign in

All three resolve credentials the same way, and take the first they find:
  1. Client credentials — QUALITY_CLIENT_ID + QUALITY_CLIENT_SECRET, for servers, containers and CI. Create the pair under Settings → API.
  2. An API token — QUALITY_TOKEN, the st-… token from your workspace.
  3. A browser login — <tool> auth login, which caches a refresh token under ~/.synq/oauth/.
The cache is shared, so one auth login covers all three for the same deployment.
If your workspace is not in the EU, add --region us (or au), or set QUALITY_REGION. The flag works on every command, and a successful login is remembered, so later commands need neither it nor --endpoint.
Confirm which workspace you are pointed at before running anything that writes. synq-scout auth whoami and synqcli auth status both print it. A synqcli deploy against the wrong region reconciles the wrong workspace — and a reconcile deletes what it does not find declared.

​
Get the command reference

Each tool’s full command and flag reference is generated from the tool itself, so it always matches the release you have: --help on any command prints the same content locally, and every tool supports shell completion.

​
Field references for the YAML

Each tool’s configuration schema is published and versioned, and each is authoritative in a way prose is not. Two forms of the same thing: a rendered page to read, and the JSON Schema to point an editor at. Put the matching line at the top of your YAML and any editor with the YAML language server gives completion and validation as you type:
The data-warehouse agent publishes its config schema the same way.

​
Use them from CI

Client credentials plus the archive download is all CI needs; no interactive login is involved. synqcli deploy --auto-confirm and synq-recon’s exit codes are the two things worth reading before wiring a pipeline — Reconciliation in CI/CD covers the second in full. Need something not covered here? Get in touch.