> asc-cli-usage
Guidance for using asc cli in this repo (flags, output formats, pagination, auth, and discovery). Use when asked to run or design asc commands or interact with App Store Connect via the CLI.
curl "https://skillshub.wtf/rudrankriyam/app-store-connect-cli-skills/asc-cli-usage?format=md"asc cli usage
Use this skill when you need to run or design asc commands for App Store Connect.
Command discovery
- Always use
--helpto discover commands and flags.asc --helpasc builds --helpasc builds list --help
Canonical verbs (0.45.x+)
- Prefer
viewover legacygetaliases for read-only commands in docs and automation.asc apps view --id "APP_ID"asc versions view --version-id "VERSION_ID"asc pricing availability view --app "APP_ID"
- Prefer
editfor update-only availability surfaces and other canonical edit flows.asc pricing availability edit --app "APP_ID" --territory "USA,GBR" --available trueasc app-setup availability edit --app "APP_ID" --territory "USA,GBR" --available trueasc xcode version edit --build-number "42"
- Keep
setwhere the CLI intentionally models a higher-level replacement/configuration flow and--helpstill showssetas the canonical verb.
Flag conventions
- Use explicit long flags (e.g.,
--app,--output). - Prefer explicit flags in automation; some newer commands can prompt for missing fields when run interactively.
- Destructive operations require
--confirm. - Use
--paginatewhen the user wants all pages.
Output formats
- Output defaults are TTY-aware:
tablein interactive terminals,jsonwhen piped or non-interactive. - Use
--output tableor--output markdownonly for human-readable output. --prettyis only valid with JSON output.
Authentication and defaults
- Prefer keychain auth via
asc auth login. - Fallback env vars:
ASC_KEY_ID,ASC_ISSUER_ID,ASC_PRIVATE_KEY_PATH,ASC_PRIVATE_KEY,ASC_PRIVATE_KEY_B64. ASC_APP_IDcan provide a default app ID.- When permissions are unclear, inspect exact API key role coverage with
asc web auth capabilities.- This lives under the experimental web auth surface.
- It can resolve the current local auth by default, or inspect a specific key with
--key-id.
Timeouts
ASC_TIMEOUT/ASC_TIMEOUT_SECONDScontrol request timeouts.ASC_UPLOAD_TIMEOUT/ASC_UPLOAD_TIMEOUT_SECONDScontrol upload timeouts.
> related_skills --same-repo
> asc-xcode-build
Build, archive, export, and manage Xcode version/build numbers with asc and xcodebuild before uploading to App Store Connect. Use when you need to create an IPA or PKG for upload.
> asc-workflow
Define, validate, and run repo-local multi-step automations with `asc workflow` and `.asc/workflow.json`. Use when migrating from lane tools, wiring CI pipelines, or orchestrating repeatable `asc` + shell release flows with hooks, conditionals, and sub-workflows.
> asc-whats-new-writer
Generate engaging, localized App Store release notes (What's New) from git log, bullet points, or free text using canonical metadata under `./metadata`. Optionally pairs with promotional text updates.
> asc-wall-submit
Submit or update a Wall of Apps entry in the App-Store-Connect-CLI repository using `asc apps wall submit`. Use when the user says "submit to wall of apps", "add my app to the wall", or "wall-of-apps".