Skip to main content

Installation

Requirements​

  • macOS 15+
  • Swift 6.2+ (only for building from source)

Homebrew​

brew install ascelerate

Homebrew installs a pre-built binary on Apple silicon Macs and builds from source on Intel Macs.

note

If you installed ascelerate from the keremerkan/tap tap before, brew update moves it to Homebrew's own formula. The tap no longer has it.

Install script​

curl -fsSL https://raw.githubusercontent.com/keremerkan/ascelerate/main/install.sh | bash

Downloads the latest release, checks that it's signed with ascelerate's Developer ID, and installs it to /usr/local/bin (creating the folder if needed), which asks for your password. Apple Silicon only. Update it later with sudo ascelerate update.

Download manually​

Download the latest release from GitHub Releases:

curl -L https://github.com/keremerkan/ascelerate/releases/latest/download/ascelerate-macos-arm64.tar.gz -o ascelerate.tar.gz
tar xzf ascelerate.tar.gz
sudo mkdir -p /usr/local/bin
sudo mv ascelerate /usr/local/bin/

The binary is signed with ascelerate's Developer ID (AKE Software GmbH) and notarized by Apple, so macOS runs it without a warning. codesign -dv /usr/local/bin/ascelerate shows the signature; sudo ascelerate update installs later releases.

note

Pre-built binaries are provided for Apple Silicon (arm64) only. Intel Mac users should build from source.

Build from source​

git clone https://github.com/keremerkan/ascelerate.git
cd ascelerate
swift build -c release
strip .build/release/ascelerate
cp .build/release/ascelerate /usr/local/bin/
note

The release build takes several minutes because it compiles the App Store Connect client that ascelerate generates from Apple's OpenAPI specification. strip removes debug symbols, reducing the binary from ~156 MB to ~41 MB.

Shell completions​

Set up tab completion for subcommands, options, and flags (supports zsh and bash):

ascelerate install-completions

This detects your shell and configures everything automatically. Restart your shell or open a new tab to activate.

AI coding skill (optional)​

If you use an AI coding agent like Claude Code, Cursor, Windsurf, or GitHub Copilot, you can install a skill file that gives it full knowledge of all ascelerate commands and workflows:

ascelerate install-skill    # detected agents (Claude Code/Cursor/Windsurf; +Copilot with --all)
npx ascelerate-skill        # any AI coding agent (no CLI needed)

See the AI Coding Skill guide for details.

Check your version​

ascelerate version     # Prints version number
ascelerate --version   # Same as above
ascelerate -v          # Same as above