Código abierto · Licencia MIT

App Store Connect,
desde tu terminal.

Una CLI en Swift para gestionar tus apps iOS y macOS en App Store Connect. Envía versiones, gestiona capturas de pantalla, rastrea builds — con soporte completo para agentes de IA mediante CAEOAS.

$ brew install tddworks/tap/asccli
130+
Comandos
CAEOAS
Listo para IA
MIT
Código abierto
100+
Endpoints API
zsh — 80×24

Funciones

Todo lo que necesitas, sin lo que no

Construido sobre la API oficial de App Store Connect, con una arquitectura de tres capas y salida completa de affordances para flujos de trabajo con agentes de IA.

Listo para agentes de IA (CAEOAS)

Cada respuesta incluye comandos listos para ejecutar en un campo affordances. Ningún agente necesita conocer el árbol de comandos completo — solo sigue los enlaces.

App
├─ AppStoreVersion
│  └─ Localization
│     └─ ScreenshotSet
├─ AppInfo
│  └─ AppInfoLocalization
├─ Build
└─ TestFlight

Jerarquía completa de recursos

Gestiona el árbol completo de recursos de App Store Connect: Apps → Versiones → Localizaciones → Conjuntos de capturas → Capturas. Más Builds y TestFlight.

$ asc versions submit \
  --version-id a9657737
// 4 API calls, 1 command:
1. GET /appStoreVersions/{id}
2. POST /reviewSubmissions
3. POST /reviewSubmissionItems
4. PATCH /reviewSubmissions/{id}
state: WAITING_FOR_REVIEW

Envío con un solo comando

Envía cualquier versión iOS o macOS a revisión con un solo comando. La CLI gestiona automáticamente el flujo completo de envío a revisión en varios pasos.

Verificación previa al envío

Ejecuta todas las comprobaciones antes de enviar con un solo comando. Detecta compilaciones faltantes, precios no configurados y localizaciones incompletas — con gravedad MUST FIX vs SHOULD FIX. La acción de envío solo aparece cuando todo está en verde.

$ asc iris status
source: browser · cookies: 5
$ asc iris apps create \
  --name "My App" \
  --bundle-id com.example.app \
  --sku MYSKU
id: 1234567890

Iris (API Privada)

Accede a la API privada que impulsa la interfaz web de App Store Connect. Crea nuevas apps, lista todas las apps — funcionalidades no disponibles a través de la API REST pública. Autenticación basada en cookies del navegador, sin configuración adicional.

# guardar clave una vez
$ asc app-shots config \
  --gemini-api-key KEY
# colocar PNGs en .asc/app-shots/ → ejecutar
$ asc app-shots generate
# localizar en un comando
$ asc app-shots translate \
  --to zh --to ja
screen-0.png · 1320×2868
zh/ ja/ ← localized

Generador de Capturas con IA

Genera screenshots de App Store en 1320×2868 con Gemini AI. Localiza en un comando — asc app-shots translate --to zh --to ja. Dimensiones correctas garantizadas.

$ asc version-localizations list \
  --version-id v1
$ asc version-localizations update \
  --localization-id id \
  --whats-new "Bug fixes"
en-US · zh-Hans · ja · ko

Localizaciones de versión

Actualiza el texto de «Novedades», descripción, palabras clave y URLs de promoción por idioma para cualquier versión de la app. CRUD completo — lista, crea y actualiza en todas las regiones.

$ asc screenshot-sets create \
  --localization-id id \
  --display-type APP_IPHONE_67
$ asc screenshots upload \
  --set-id id --file screen.png
3-step ASC upload flow

Capturas de pantalla

Crea conjuntos de capturas para cualquier tamaño de pantalla y sube imágenes PNG con el flujo de carga de 3 pasos de ASC. Compatible con todos los tipos de pantalla de iPhone, iPad, Mac y Apple TV.

$ asc app-preview-sets create \
  --localization-id id \
  --preview-type IPHONE_67
$ asc app-previews upload \
  --set-id id --file preview.mp4 \
  --preview-frame-time-code 00:00:05

Previsualizaciones de app

Sube previsualizaciones en vídeo (.mp4, .mov, .m4v) con código de tiempo de miniatura opcional. El CLI gestiona el flujo completo de 3 pasos: reserva, carga por fragmentos y confirmación MD5.

$ asc app-info-localizations list \
  --app-info-id id
$ asc app-info-localizations update \
  --localization-id id \
  --name "My App" \
  --subtitle "Do things faster"

Localizaciones de información de app

Lee y escribe metadatos de app por idioma: nombre, subtítulo y URL de política de privacidad. Metadatos a nivel de app que aplican a todas las versiones — separados de las localizaciones de versión.

# configuración única
$ asc auth login \
  --key-id KEY \
  --private-key-path ~/.asc/Key.p8
guardado en ~/.asc/credentials.json
# sin variables de entorno desde ahora
$ asc apps list

Autenticación persistente

Inicia sesión una vez con asc auth login. Las credenciales se guardan en ~/.asc/credentials.json y son utilizadas automáticamente por cada comando. Sin variables de entorno por sesión.

$ asc builds upload \
  --app-id id --file MyApp.ipa \
  --version 1.2.0 --build-number 55
// 5-step flow:
1. Reserve slot
2. Upload chunks
3. Confirm MD5
state: processing

Subida de builds

Sube IPA/PKG con el flujo de 5 pasos de ASC: reservar slot, subir fragmentos, confirmar MD5 y esperar el procesamiento. Incluye listado, consulta y eliminación de registros de subida.

$ asc testflight groups list \
  --app-id id
$ asc testflight testers add \
  --beta-group-id id \
  --email [email protected]
$ asc testflight testers import \
  --beta-group-id id --file testers.csv

TestFlight

Gestiona grupos beta y testers: añade o elimina por email, importa/exporta en masa con CSV, distribuye builds a grupos y actualiza las notas de novedades por idioma.

Múltiples formatos de salida

Diseñado para humanos y máquinas. Salida en JSON (por defecto), tabla o markdown. Conecta fácilmente con jq, scripts o agentes de IA.

$ asc iap create --app-id id \
  --type consumable \
  --reference-name "Coins 100"
$ asc iap prices set \
  --iap-id id --base-territory USA \
  --price-point-id id
$ asc iap submit --iap-id id

Compras dentro de la app

Crea IAPs consumibles, no consumibles y de suscripción no renovable. Establece precios por territorio desde los puntos de precio de App Store, gestiona nombre y descripción por idioma y envía a revisión.

$ asc subscription-groups create \
  --app-id id --reference-name "Pro"
$ asc subscriptions create \
  --group-id id --period ONE_MONTH
$ asc subscription-offers create \
  --subscription-id id \
  --mode FREE_TRIAL --periods 7

Suscripciones de renovación automática

Crea grupos de suscripciones y niveles (semanal a anual). Gestiona ofertas introductorias (prueba gratuita, pago por uso, pago anticipado), metadatos por idioma y envía a revisión.

$ asc bundle-ids create \
  --name "My App" \
  --identifier com.example.app \
  --platform ios
$ asc profiles create \
  --type IOS_APP_STORE \
  --bundle-id-id id --certificate-ids id

Firma de código

Gestiona la cadena de firma completa: registra Bundle IDs, crea certificados desde CSR, registra dispositivos por UDID y crea o elimina perfiles de aprovisionamiento — todo desde el terminal.

$ asc tui
┌─ Apps ─────────────────────────┐
▶ AppNexus
│  My Other App
└────────────────────────────────┘
↑↓ navigate · Enter · Esc back

Modo TUI interactivo

Ejecuta asc tui para abrir un navegador TUI completo en el terminal. Navega por apps, versiones, builds y TestFlight con teclas de flecha — sin memorizar comandos. Ideal para explorar.

Inicio rápido

En funcionamiento en minutos

1
$ brew install tddworks/tap/asccli
🍺 Pouring asc...
asc installed
$ asc --version
asc 1.0.0

Instalar con Homebrew

Un comando instala la última versión. No se requiere Xcode ni cadena de herramientas de Swift.

2
$ asc auth login \
  --key-id YOUR_KEY_ID \
  --issuer-id YOUR_ISSUER \
  --private-key-path ~/.asc/Key.p8
$ asc auth check
source: "file" · key: YOUR_KEY_ID
# guardado en ~/.asc/credentials.json

Inicia sesión una vez, úsalo siempre

Guarda tu clave API con asc auth login. Las credenciales se almacenan en ~/.asc/credentials.json — sin variables de entorno por sesión.

3
$ asc apps list
$ asc versions list --app-id <id>
$ asc screenshots upload \
  --set-id <id> --file shot.png
$ asc versions submit \
  --version-id <id>
Submitted for review

Empieza a gestionar tus apps

Lista apps, inspecciona versiones, sube capturas de pantalla y envía a revisión — todo desde tu terminal o mediante un agente de IA.

Habilidades del agente

Potencia tu agente de IA

Instala más de 26 habilidades prediseñadas que enseñan a tu agente de codificación IA cómo usar cada comando asc — desde subidas hasta envíos.

$ asc skills install --all

asc-builds-upload

Sube builds IPA/PKG y gestiona la distribución TestFlight

asc-app-shots

Genera y traduce capturas de pantalla del App Store con IA

asc-check-readiness

Verificaciones previas antes de enviar a revisión

asc-auth

Configura y gestiona las credenciales de la API de App Store Connect

asc-testflight

Gestiona grupos beta y testers para TestFlight

asc-release-workflow

Lanzamiento de extremo a extremo: versionar, archivar, subir, enviar

Más de 26 habilidades disponibles — compatible con Claude Code, Cursor, Windsurf y más

¿Listo para probar asc?

Automatiza tu flujo de trabajo en App Store Connect

$ brew install tddworks/tap/asccli

Comunidad

App Wall

Apps reales publicadas en el App Store por desarrolladores usando asc CLI.

$ asc app-wall submit --app-id <your-app-id>

Un solo comando para enviar tu app y abrir un pull request →

Built for real apps

Sponsors