The fastest path to a working Synsci CLI is the one-line installer:
npx synsci
This runs the full install in one step. It downloads the platform binary, drops synsc on your PATH, walks you through dashboard authentication, and pre-fetches your synced credentials so the first session is ready to go. No follow-up commands required.
After npx synsci finishes, run synsc web to open the recommended browser UI, see the Web UI page. The TUI and desktop app are both still available if you prefer them.

What npx synsci does

1

Download the binary

The installer detects your OS and architecture and pulls the matching synsc binary from the release CDN. It places the binary in your platform’s standard user-bin location and adds the directory to your shell PATH if it’s not already there.
2

Authenticate to your dashboard

The installer launches the device-flow OAuth login against cli.syntheticsciences.ai. You confirm the device code in your browser and the installer receives a Bearer token.
3

Sync credentials and credits

With the Bearer token, the installer fetches your credit balance and the list of synced credentials (HF, W&B, Modal, Lambda, AWS, GCP). The token is stored in OS keychain so future sessions don’t need to log in again.
4

Verify and exit

A short health check confirms synsc --version runs, the dashboard is reachable, and credentials are present. Then the installer exits cleanly.
You can re-run npx synsci any time to refresh the install or repair a broken one.

Manual install paths

If you’d rather not use the all-in-one installer, three direct paths drop the same binary on your PATH. After any of them, run synsc connect login once to authenticate.
npm install -g @synsci/cli
synsc connect login
Cross-platform. Picks the right platform binary at install time. Updates land via npm update -g @synsci/cli or synsc upgrade.

Desktop app

A separate native app for macOS, Windows, and Linux is available if you’d rather have a full windowed UI than synsc web. Download from the GitHub releases page. See Desktop app for details.

Verify the install

synsc --version
synsc connect status
Healthy output prints the binary version, your account email, the synced credentials available, and your current credit balance.

Upgrade and uninstall

synsc upgrade        # upgrade to the latest version
synsc uninstall      # remove the binary and clear local config
synsc uninstall does not affect your dashboard account, credits, or session history, only the local install.

What’s next

  • Quickstart. Connect, send your first prompt, and switch agents and models, under five minutes.
  • Web UI. synsc web, the recommended way to use Synsci CLI day-to-day.