Skip to main content

​
Installation

Install the App Store Connect CLI on macOS, Linux, or from source
The App Store Connect CLI (asc) is distributed as a single binary with no runtime dependencies. Choose the installation method that works best for your environment.

​
Requirements

  • Operating System: macOS or Linux
  • Architecture: x86_64 (amd64) or ARM64 (arm64/aarch64)
  • Go: 1.26+ (only required for source builds)
The easiest way to install asc on macOS or Linux:
Homebrew automatically manages updates. Run brew upgrade asc to get the latest version.

​
Verify installation

Expected output:

​
Install script

For automated setups or environments without Homebrew:

​
What the script does

1

Detect your platform

Automatically identifies your OS (macOS/Linux) and architecture (amd64/arm64)
2

Download the latest release

Fetches the appropriate binary from GitHub Releases
3

Verify checksums

Validates the downloaded binary using SHA-256 checksums (if shasum or sha256sum is available)
4

Install to bin directory

Installs to ~/.local/bin by default (or /usr/local/bin if $HOME is not set)
The install script may prompt for sudo if the target directory requires elevated permissions.

​
Add to PATH

If ~/.local/bin is not in your PATH, add it to your shell profile:
Reload your shell:

​
Manual download

For maximum control, download binaries directly from GitHub:
1

Visit releases page

Go to github.com/rorkai/App-Store-Connect-CLI/releases/latest
2

Download your platform binary

Choose the appropriate file:
  • asc_v{version}_macOS_amd64 (Intel Mac)
  • asc_v{version}_macOS_arm64 (Apple Silicon)
  • asc_v{version}_linux_amd64 (Linux x86_64)
  • asc_v{version}_linux_arm64 (Linux ARM64)
3

Make it executable

4

Move to PATH

​
Build from source

For contributors or custom builds:
1

Clone the repository

2

Build the binary

This creates ./asc in the project root.
3

Install locally (optional)

This installs to $GOPATH/bin (typically ~/go/bin).
See CONTRIBUTING.md for development setup, testing, and PR guidelines.

​
Development tools

Install optional tooling for linting and formatting:

​
Run tests

Always use ASC_BYPASS_KEYCHAIN=1 when running tests to avoid macOS keychain prompts and environment bleed-through.

​
Shell completion

asc supports shell completion for bash, zsh, and fish.
Reload your shell to activate completions.

​
Upgrading

​
Uninstalling

​
Troubleshooting

​
Binary not found

If asc is not in your PATH:
If this returns nothing, check your installation directory and add it to PATH.

​
Permission denied

If you get a “permission denied” error:

​
macOS Gatekeeper warning

On macOS, you may see a security warning on first run. Allow the binary:
Or go to System Preferences → Security & Privacy → General and click “Allow Anyway”.

​
Next steps

Authentication

Configure your App Store Connect API credentials

Quickstart

Run your first commands and explore workflows