Skip to main content
Version: v4 (current)

Command Line

Use the public game-ci CLI for command-line builds and other engine automation. Orchestrator is loaded as a provider plugin, so the user-facing command is game-ci orchestrate while provider-specific behavior stays in the Orchestrator package.

Install GameCI CLI​

Linux / macOS​

curl -fsSL https://raw.githubusercontent.com/game-ci/cli/main/install.sh | sh

Windows (PowerShell)​

irm https://raw.githubusercontent.com/game-ci/cli/main/install.ps1 | iex

The standalone Orchestrator CLI can also be installed directly for provider development. See Standalone Orchestrator CLI.

Examples​

Local build​

game-ci \
  --plugin @game-ci/orchestrator-plugin \
  orchestrate ./my-project \
  --provider-strategy local-docker \
  --target-platform StandaloneLinux64

Cloud build (AWS)​

game-ci \
  --plugin @game-ci/orchestrator-plugin \
  orchestrate ./my-project \
  --provider-strategy aws \
  --target-platform StandaloneLinux64 \
  --git-private-token $GIT_TOKEN

Cloud build (Kubernetes)​

game-ci \
  --plugin @game-ci/orchestrator-plugin \
  orchestrate ./my-project \
  --provider-strategy k8s \
  --target-platform StandaloneLinux64 \
  --git-private-token $GIT_TOKEN

Standalone maintenance commands​

Some maintenance commands are available only on the standalone Orchestrator CLI.

game-ci list-resources --provider-strategy aws

Watch a running build​

game-ci watch --provider-strategy aws

Clean up old resources​

game-ci garbage-collect --provider-strategy aws

Cleans up stale cloud resources (AWS only): stops old ECS tasks, deletes job CloudFormation stacks, and removes old CloudWatch log groups. Resources are deleted immediately without confirmation. Use --garbageMaxAge to control the age threshold (default: 24 hours).

Keeping Commands Short​

Avoid long CLI flags for credentials by using environment variables or the Pull Secrets feature:

game-ci \
  --plugin @game-ci/orchestrator-plugin \
  orchestrate ./my-project \
  --provider-strategy aws \
  --target-platform StandaloneLinux64 \
  --pull-input-list UNITY_EMAIL,UNITY_SERIAL,UNITY_PASSWORD \
  --input-pull-command 'gcloud secrets versions access 1 --secret="{0}"'

Further Reading​