| name | asc-app-infos |
| description | Manage App Store app info and per-locale metadata using the `asc` CLI tool.
Use this skill when:
(1) Listing app info records: "asc app-infos list --app-id ID"
(2) Updating app categories: "asc app-infos update --app-info-id ID --primary-category 6014"
(3) Browsing categories: "asc app-categories list --platform IOS"
(4) Listing per-locale app metadata: "asc app-info-localizations list --app-info-id ID"
(5) Creating a new locale entry: "asc app-info-localizations create --app-info-id ID --locale en-US --name 'My App'"
(6) Updating name, subtitle, or privacy URLs: "asc app-info-localizations update --localization-id ID --name 'New Name'"
(7) Deleting a locale entry: "asc app-info-localizations delete --localization-id ID"
(8) Navigating to age rating: "asc age-rating get --app-info-id ID" (use getAgeRating affordance)
(9) User says "update app name", "update subtitle", "set privacy policy URL", "list app info", "manage app metadata", "set category", "update category"
|
asc App Info & Localizations
Manage app-level metadata (name, subtitle, privacy policy URLs, categories) via the asc CLI.
Note: This is distinct from version-level metadata (asc version-localizations) which handles
"What's New", description, and keywords. App info localizations hold the persistent app name and subtitle.
List App Infos
Each app has one AppInfo record (rarely more). Get the AppInfo ID needed for subsequent commands.
asc app-infos list --app-id <APP_ID> [--pretty]
JSON output:
{
"data": [
{
"id": "info-abc123",
"appId": "6746148194",
"affordances": {
"getAgeRating": "asc age-rating get --app-info-id info-abc123",
"listAppInfos": "asc app-infos list --app-id 6746148194",
"listLocalizations": "asc app-info-localizations list --app-info-id info-abc123",
"updateCategories": "asc app-infos update --app-info-id info-abc123"
}
}
]
}
Update App Info (Categories)
Set primary and/or secondary category. All flags are optional (PATCH semantics).
asc app-infos update --app-info-id <APP_INFO_ID> \
[--primary-category GAMES] \
[--primary-subcategory-one GAMES_ACTION] \
[--secondary-category UTILITIES]
List App Categories
Browse all App Store category IDs (required for app-infos update).
asc app-categories list [--platform IOS|MAC_OS|TV_OS] [--output table]
Sample IDs: GAMES, GAMES_ACTION, GAMES_PUZZLE, GAMES_ADVENTURE, BUSINESS, UTILITIES, EDUCATION, HEALTH_AND_FITNESS, ENTERTAINMENT, SOCIAL_NETWORKING, PRODUCTIVITY, FINANCE, MUSIC, TRAVEL, SPORTS
Subcategories follow the pattern PARENT_SUBTYPE (e.g. GAMES_ACTION is under GAMES). The API does not return a parentId field.
List Localizations
asc app-info-localizations list --app-info-id <APP_INFO_ID> [--output table]
Table output:
ID Locale Name Subtitle
-------- -------- -------------- --------------------
loc-001 en-US My App Do things faster
loc-002 zh-Hans 我的应用 更快地完成任务
Create Localization
Create a new locale entry. --name is required (up to 30 characters).
asc app-info-localizations create \
--app-info-id <APP_INFO_ID> \
--locale zh-Hans \
--name "我的应用"
Common locales: en-US, zh-Hans, zh-Hant, ja, ko, de, fr
Update Localization
All fields are optional — only provided fields are changed (PATCH semantics).
asc app-info-localizations update \
--localization-id <LOCALIZATION_ID> \
[--name "New App Name"] \
[--subtitle "Do things faster"] \
[--privacy-policy-url "https://example.com/privacy"] \
[--privacy-choices-url "https://example.com/choices"] \
[--privacy-policy-text "Our privacy policy text"]
| Flag | Description |
|---|
--name | App name (up to 30 characters) |
--subtitle | Subtitle (up to 30 characters) |
--privacy-policy-url | Main privacy policy URL |
--privacy-choices-url | Privacy choices/opt-out URL |
--privacy-policy-text | Inline privacy policy text |
Delete Localization
Remove a locale entry permanently.
asc app-info-localizations delete --localization-id <LOCALIZATION_ID>
CAEOAS Affordances
Every response includes ready-to-run follow-up commands:
AppInfo:
{
"affordances": {
"getAgeRating": "asc age-rating get --app-info-id <ID>",
"listAppInfos": "asc app-infos list --app-id <APP_ID>",
"listLocalizations": "asc app-info-localizations list --app-info-id <ID>",
"updateCategories": "asc app-infos update --app-info-id <ID>"
}
}
AppInfoLocalization:
{
"affordances": {
"delete": "asc app-info-localizations delete --localization-id <ID>",
"listLocalizations": "asc app-info-localizations list --app-info-id <APP_INFO_ID>",
"updateLocalization": "asc app-info-localizations update --localization-id <ID>"
}
}
AppCategory:
{
"affordances": {
"listCategories": "asc app-categories list"
}
}
Resolve App ID
See project-context.md — check .asc/project.json before asking the user or running asc apps list.
Typical Workflow
APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
APP_INFO_ID=$(asc app-infos list --app-id "$APP_ID" | jq -r '.data[0].id')
asc app-info-localizations list --app-info-id "$APP_INFO_ID" --output table
LOC_ID=$(asc app-info-localizations list --app-info-id "$APP_INFO_ID" \
| jq -r '.data[] | select(.locale == "en-US") | .id')
asc app-info-localizations update \
--localization-id "$LOC_ID" \
--name "My App" \
--subtitle "Do things faster" \
--privacy-policy-url "https://example.com/privacy"
asc app-info-localizations create \
--app-info-id "$APP_INFO_ID" \
--locale zh-Hans \
--name "我的应用"
asc app-info-localizations delete --localization-id <LOCALIZATION_ID>
asc app-categories list --platform IOS --output table
asc app-infos update \
--app-info-id "$APP_INFO_ID" \
--primary-category GAMES \
--primary-subcategory-one GAMES_ACTION
asc age-rating get --app-info-id "$APP_INFO_ID"
Two Localization Types
| Type | Commands | Fields |
|---|
AppInfoLocalization | asc app-info-localizations * | name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText |
AppStoreVersionLocalization | asc version-localizations * | whatsNew, description, keywords, screenshots |
App info localizations are persistent across app versions. Version localizations are per-release.
