| name | asc-install |
| description | Make the asc command available, installing it only if it is missing. Use when another skill reports that `asc` is not on PATH, or when the user asks to install, update or upgrade the ideamans App Store Connect CLI. Prefers an already-installed binary, then the latest GitHub release, then a build from source with go install. |
| license | MIT |
| compatibility | Requires curl (or wget) and tar to install from a release, or a Go toolchain for the source fallback. Standalone — does not need asc to be present already. Installs from the public repository github.com/ideamans/apple-app-store-connect-cli, so no GitHub authentication is needed. |
| allowed-tools | Bash(curl:*) Bash(wget:*) Bash(tar:*) Bash(unzip:*) Bash(go:*) Bash(uname:*) Bash(command:*) Bash(which:*) Bash(mkdir:*) Bash(mv:*) Bash(cp:*) Bash(rm:*) Bash(chmod:*) Bash(ls:*) Bash(test:*) Bash(echo:*) Read |
asc-install
Make the asc command usable, doing the least work that achieves it.
Route 1 — an existing installation on PATH
command -v asc && asc --version
If that resolves, use it and stop here. Do not check for a newer release —
it costs an API call and the user did not ask for an upgrade.
Two checks before trusting the hit:
- It is the right tool.
asc is a short name that other things may own.
asc llm | head -1 must read
# asc — Apple App Store Connect API CLI (reference for AI agents). If
something else owns the name, tell the user and use an explicit path rather
than shadowing theirs.
- It is recent enough. If
asc llm is not a known command, the binary
predates the embedded reference. Say so and continue to route 2 to upgrade it.
Continue past this section only when the command is missing, is the wrong tool,
is too old, or the user explicitly asked to update.
Route 2 — the latest GitHub release
The repository is public, so no authentication is needed.
VERSION=$(curl -fsSL https://api.github.com/repos/ideamans/apple-app-store-connect-cli/releases/latest \
| grep '"tag_name"' | head -1 | cut -d'"' -f4)
The archive is named after the goreleaser project, not the repository —
apple-app-store-connect, without the -cli suffix:
apple-app-store-connect_<version-without-v>_<os>_<arch>.tar.gz
<os> is darwin, linux or windows (lowercase); <arch> is amd64 or
arm64, so uname -m reporting x86_64 maps to amd64. Windows ships a
.zip.
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m); [ "$ARCH" = "x86_64" ] && ARCH=amd64
curl -fsSL -o /tmp/asc.tar.gz \
"https://github.com/ideamans/apple-app-store-connect-cli/releases/download/${VERSION}/apple-app-store-connect_${VERSION#v}_${OS}_${ARCH}.tar.gz"
If the download 404s, list the actual assets on the release page rather than
retrying variations.
Install onto PATH
tar -xzf /tmp/asc.tar.gz -C /tmp
mkdir -p ~/.local/bin && mv /tmp/asc ~/.local/bin/ && chmod +x ~/.local/bin/asc
Prefer the first writable directory already on PATH — ~/.local/bin, then
/usr/local/bin. Two things not to do on your own initiative:
- If nothing on PATH is writable, leave the binary in
/tmp, print the exact
sudo mv command and let the user run it. Do not run sudo yourself.
- If
~/.local/bin is not on PATH, give the user the line to add to their shell
profile. Do not edit the profile for them.
Route 3 — build from source
Needs a Go toolchain and compiles rather than downloads, so it is the last
resort — but it covers platforms the release assets miss. Note the /cmd/asc
suffix; installing the module root would not build anything.
go install github.com/ideamans/apple-app-store-connect-cli/cmd/asc@latest
The binary lands in $(go env GOPATH)/bin and is named asc.
Verify
asc --version
asc llm | head -5
Report which route was taken, the version and the install path.
Then say what is still needed: asc cannot do anything without an App Store
Connect API key. If the user has not run asc configure, tell them now rather
than letting the first real command fail with a 401 — they will need the issuer
id, the key id and the .p8 file from App Store Connect → Users and Access →
Integrations.
