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.
What npx synsci does
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.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.
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.
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, runsynsc connect login once to authenticate.
- npm
- Homebrew (macOS)
- curl install
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 thansynsc web. Download from the GitHub releases page. See Desktop app for details.
Verify the install
Upgrade and uninstall
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.