Skip to content

installation.mdx

Latest commit

 

History

History
326 lines (237 loc) · 7.71 KB

installation.mdx

File metadata and controls

326 lines (237 loc) · 7.71 KB
Raw

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: Not required for released binaries. Source builds use the version declared by go.mod.

Homebrew (recommended)

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:

```bash macOS/Linux theme={null} curl -fsSL https://asccli.sh/install | bash ``` 
INSTALL_DIR="$HOME/bin" curl -fsSL https://asccli.sh/install | bash

What the script does

Automatically identifies your OS (macOS/Linux) and architecture (amd64/arm64) Fetches the appropriate binary from [GitHub Releases](https://github.com/rorkai/App-Store-Connect-CLI/releases/latest) Validates the downloaded binary against the release SHA-256 checksums. The script aborts if verification cannot run (missing `checksums.txt`, missing `shasum`/`sha256sum`, or an unlisted asset); set `ASC_INSTALL_INSECURE=1` to explicitly skip verification in emergencies. A checksum mismatch always aborts. 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:

```bash bash (~/.bashrc or ~/.bash_profile) theme={null} export PATH="$HOME/.local/bin:$PATH" ``` 
export PATH="$HOME/.local/bin:$PATH"
set -gx PATH $HOME/.local/bin $PATH

Reload your shell:

source ~/.bashrc  # or ~/.zshrc, etc.

Manual download

For maximum control, download binaries directly from GitHub:

Go to [github.com/rorkai/App-Store-Connect-CLI/releases/latest](https://github.com/rorkai/App-Store-Connect-CLI/releases/latest) 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)
```bash theme={null} chmod +x asc_v* ``` ```bash theme={null} mv asc_v* /usr/local/bin/asc ```

Build from source

For contributors or custom builds:

```bash theme={null} git clone https://github.com/rorkai/App-Store-Connect-CLI.git cd App-Store-Connect-CLI ``` ```bash theme={null} make build ``` 
This creates `./asc` in the project root.
```bash theme={null} make install ``` 
This installs to `$GOPATH/bin` (typically `~/go/bin`).
See [CONTRIBUTING.md](https://github.com/rorkai/App-Store-Connect-CLI/blob/main/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.

Agent skills

asc can install the App Store Connect workflow skills globally so your agent can use them across projects:

asc install-skills

asc install-skills checks out reviewed commit e30039abddbe388179324d0f9cdccb66c3843115 and copies its 23 skills directly into the standard global agent-skills directory. It verifies the complete pack and every installed file before succeeding, preserves unrelated skills and unrelated lock entries, and pins the 23 ASC lock entries to the same reviewed commit so external checks cannot update them from a mutable branch. It rolls back the pack if any replacement fails. Only git is required; the command does not execute Node.js, npx, npm packages, or repository scripts.

git --version
asc install-skills
Upgrading the skill pack is an explicit change to the pinned commit and the reviewed 23-skill manifest in `internal/cli/install/install.go`.

Shell completion

asc supports shell completion for bash, zsh, and fish.

```bash bash theme={null} asc completion --shell bash > /usr/local/etc/bash_completion.d/asc ``` 
asc completion --shell zsh > "${fpath[1]}/_asc"
asc completion --shell fish > ~/.config/fish/completions/asc.fish

Reload your shell to activate completions.

Upgrading

```bash theme={null} brew upgrade asc ``` Re-run the install script to get the latest version: 
```bash  theme={null}
curl -fsSL https://asccli.sh/install | bash
```
Download the latest binary from [releases](https://github.com/rorkai/App-Store-Connect-CLI/releases/latest) and replace your existing binary. ```bash theme={null} git pull make build make install ```

Uninstalling

```bash theme={null} brew uninstall asc ``` Remove the binary and config: 
```bash  theme={null}
rm /usr/local/bin/asc        # or ~/.local/bin/asc
rm -rf ~/.asc                # config and credentials
```

Optionally remove keychain entries:

```bash  theme={null}
asc auth logout --all --confirm  # before removing binary
```

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

Configure your App Store Connect API credentials Run your first commands and explore workflows