aso-cli

aso-cli

Keyword intelligence CLI for App Store Optimization. Built for AI agents and developers.

A lightweight CLI client for asomaniac.com — keyword analysis, recommendations, and storefront intelligence for iOS, macOS, and other App Store markets.

Quick start

brew install asomaniac/tap/aso
aso auth login
aso keywords analyze "vpn" --storefront us

Installation

Homebrew (recommended):

brew install asomaniac/tap/aso

Install script (macOS / Linux):

curl -fsSL https://raw.githubusercontent.com/ASOManiac/aso-cli/main/install.sh | bash

Go install:

go install github.com/ASOManiac/aso-cli@latest

Binary: download from Releases.

Authentication

Authenticate with your asomaniac.com API key. Three methods:

# 1. Browser OAuth (interactive)
aso auth login

# 2. Direct API key (from asomaniac.com/settings)
aso auth login --api-key asm_k_abc123

# 3. Environment variable (CI / scripts / automation)
export ASO_MANIAC_API_KEY=asm_k_abc123

Resolution order: env var > ~/.asomaniac/config.json.

aso auth status
aso auth whoami

Commands

# Analyze a keyword — popularity, difficulty, top-ranking apps
aso keywords analyze "photo editor" --storefront us

# Keyword recommendations from a seed
aso keywords recommend "fitness tracker" --storefront us --limit 20

# Batch analyze multiple keywords across storefronts
aso keywords batch "vpn,proxy,privacy" --storefronts us,gb,de

# List all supported storefronts
aso storefronts

Run aso --help for the full command tree.

Output formats

JSON by default for piping to jq and AI agents:

aso keywords analyze "vpn" --storefront us | jq '.popularity'
aso keywords analyze "vpn" --output table

For AI agents

Designed for integration with AI agent workflows. See aso-skills for prebuilt agent skills and recipes. JSON is the default output format in non-interactive environments.

For App Store Connect operations

For ASC operations (builds, TestFlight, submissions, metadata), use:

• Primary: fastlane
• Fallback: App Store Connect CLI

These are not bundled with aso-cli. Install them separately as needed.

License

MIT — see LICENSE.

Contributing

git clone https://github.com/ASOManiac/aso-cli.git
cd aso-cli
make build
ASC_BYPASS_KEYCHAIN=1 make test

See CONTRIBUTING.md.