Start

Install and connect

Install the CLI and sign in to Zeroshot Cloud. Before the first run, choose the repository and connect the GitHub access Cloud needs.

1
Install the CLI
Run this with Node.js 22 or newer. The npm package picks the Zeroshot CLI binary for your operating system.
Terminal
Zeroshot
```
npm install --global @the-open-engine-company/zeroshot
zeroshot --version
```
2
Add and authenticate Cloud
Add Zeroshot Cloud under the name cloud, then sign in. The CLI calls a saved run destination a target; it stores the target URL in its config and keeps your refresh credential in the operating system credential store.
Terminal
Zeroshot
```
zeroshot target add cloud \
  --url https://api.cloud.zeroshot.sh

zeroshot target login cloud
```
3
Select a repository
Replace the example repository and branch, then run the command. Setup saves them as the default checkout for cloud. A later run can send its own workflow and runtime settings or use a saved profile, but it always needs task input.
Terminal
Zeroshot
```
zeroshot target setup cloud \
  --repository your-org/your-repo \
  --branch main
```
Connect GitHub for Cloud runs
Open Connections in the organization console and connect your GitHub account. If the repository belongs to a GitHub organization, a Zeroshot owner or admin must also install the GitHub App and grant it access to that repository. Your local gh login does not configure Cloud.

Install the CLI