# Asc App Infos

> 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"

- Skill: `tddworks/asc-app-infos` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tddworks/asc-app-infos`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tddworks/asc-app-infos/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tddworks (https://skillmd.com/u/tddworks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tddworks/asc-app-infos

---


# 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.

```bash
asc app-infos list --app-id <APP_ID> [--pretty]
```

**JSON output:**
```json
{
  "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).

```bash
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`).

```bash
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

```bash
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).

```bash
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).

```bash
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.

```bash
asc app-info-localizations delete --localization-id <LOCALIZATION_ID>
```

## CAEOAS Affordances

Every response includes ready-to-run follow-up commands:

**AppInfo:**
```json
{
  "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:**
```json
{
  "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:**
```json
{
  "affordances": {
    "listCategories": "asc app-categories list"
  }
}
```

## Resolve App ID

See [project-context.md](../shared/project-context.md) — check `.asc/project.json` before asking the user or running `asc apps list`.

## Typical Workflow

```bash
APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`

# 1. Get the AppInfo ID
APP_INFO_ID=$(asc app-infos list --app-id "$APP_ID" | jq -r '.data[0].id')

# 2. See existing localizations
asc app-info-localizations list --app-info-id "$APP_INFO_ID" --output table

# 3a. Update an existing locale
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"

# 3b. Add a new locale
asc app-info-localizations create \
  --app-info-id "$APP_INFO_ID" \
  --locale zh-Hans \
  --name "我的应用"

# 3c. Remove an unwanted locale
asc app-info-localizations delete --localization-id <LOCALIZATION_ID>

# 4. Set app category
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

# 5. Check age rating (navigate via affordance)
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.