Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asccli.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
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: 
brew install asc
Homebrew automatically manages updates. Run brew upgrade asc to get the latest version.

​
Verify installation

asc --version
Expected output: 
v1.2.3 (commit: abc1234, date: 2026-03-04)

​
Install script

For automated setups or environments without Homebrew: 
curl -fsSL https://asccli.sh/install | bash

​
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: 
export PATH="$HOME/.local/bin:$PATH"
Reload your shell: 
source ~/.bashrc  # or ~/.zshrc, etc.

​
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

chmod +x asc_v*
4

Move to PATH

mv asc_v* /usr/local/bin/asc

​
Build from source

For contributors or custom builds:
1

Clone the repository

git clone https://github.com/rorkai/App-Store-Connect-CLI.git
cd App-Store-Connect-CLI
2

Build the binary

make build
This creates ./asc in the project root.
3

Install locally (optional)

make install
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: 
make tools   # installs gofumpt + golangci-lint
make lint    # run linter
make format  # format code

​
Run tests

ASC_BYPASS_KEYCHAIN=1 make test
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. 
asc completion --shell bash > /usr/local/etc/bash_completion.d/asc
Reload your shell to activate completions.

​
Upgrading

brew upgrade asc

​
Uninstalling

brew uninstall asc

​
Troubleshooting

​
Binary not found

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

​
Permission denied

If you get a “permission denied” error: 
chmod +x /path/to/asc

​
macOS Gatekeeper warning

On macOS, you may see a security warning on first run. Allow the binary: 
xattr -d com.apple.quarantine /usr/local/bin/asc
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