Open Source · Licença MIT

App Store Connect,
do seu terminal.

Uma CLI Swift para gerenciar seus apps iOS e macOS no App Store Connect. Envie versões, gerencie capturas de tela, monitore builds — com suporte completo a agentes de IA via CAEOAS.

$ brew install tddworks/tap/asccli
130+
Comandos
CAEOAS
Pronto para IA
MIT
Open Source
100+
Endpoints API
zsh — 80×24

Recursos

Tudo que você precisa, nada que não precisa

Construído sobre a API oficial do App Store Connect, com uma arquitetura limpa de três camadas e saída completa de affordances para workflows de agentes de IA.

Pronto para agentes de IA (CAEOAS)

Cada resposta incorpora comandos prontos para execução em um campo affordances. Nenhum agente precisa conhecer a árvore completa de comandos — basta seguir os links.

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

Hierarquia completa de recursos

Gerencie toda a árvore de recursos do App Store Connect: Apps → Versões → Localizações → Conjuntos de capturas → Capturas. Mais Builds e 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

Envio com um único comando

Envie qualquer versão iOS ou macOS para revisão com um único comando. A CLI trata automaticamente todo o fluxo de submissão de revisão em múltiplas etapas.

Verificação pré-envio

Execute todas as verificações antes de enviar com um único comando. Detecta builds ausentes, preços não configurados e localizações incompletas — com severidade MUST FIX vs SHOULD FIX. A ação de envio só aparece quando tudo está 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)

Acesse a API privada que alimenta a interface web do App Store Connect. Crie novos apps, liste todos os apps — funcionalidades não disponíveis pela API REST pública. Autenticação baseada em cookies do navegador, sem configuração adicional.

# salvar chave uma vez
$ asc app-shots config \
  --gemini-api-key KEY
# colocar PNGs em .asc/app-shots/ → executar
$ asc app-shots generate
# localizar em um comando
$ asc app-shots translate \
  --to zh --to ja
screen-0.png · 1320×2868
zh/ ja/ ← localized

Gerador de Capturas com IA

Gere screenshots do App Store em 1320×2868 com Gemini AI. Localize em um comando — asc app-shots translate --to zh --to ja. Dimensões corretas garantidas.

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

Localizações de versão

Atualize o texto «Novidades», descrição, palavras-chave e URLs promocionais por idioma para qualquer versão do app. CRUD completo — liste, crie e atualize em todas as regiões suportadas.

$ 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 ecrã

Crie conjuntos de capturas para qualquer tamanho de ecrã e carregue imagens PNG com o fluxo de upload ASC em 3 etapas. Suporta todos os tipos de ecrã iPhone, iPad, Mac e 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

Pré-visualizações de app

Carregue pré-visualizações em vídeo (.mp4, .mov, .m4v) com código de tempo de miniatura opcional. O CLI gere o fluxo completo de 3 etapas: reserva, upload por fragmentos e confirmação 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"

Localizações de informações do app

Leia e escreva metadados do app por idioma: nome, subtítulo e URL da política de privacidade. Metadados ao nível do app aplicáveis a todas as versões — separados das localizações de versão.

# configuração única
$ asc auth login \
  --key-id KEY \
  --private-key-path ~/.asc/Key.p8
salvo em ~/.asc/credentials.json
# sem variáveis de ambiente daqui em diante
$ asc apps list

Autenticação persistente

Faça login uma vez com asc auth login. As credenciais são salvas em ~/.asc/credentials.json e utilizadas automaticamente por cada comando. Sem variáveis de ambiente por sessão.

$ 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

Upload de builds

Carregue IPA/PKG com o fluxo ASC de 5 etapas: reservar slot, upload por fragmentos, confirmar MD5 e aguardar processamento. Inclui listagem, consulta e eliminação de registos de upload.

$ 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

Gira grupos beta e testadores: adicione ou remova por email, importe/exporte em massa via CSV, distribua builds para grupos e atualize notas de novidades por idioma.

Múltiplos formatos de saída

Projetado para humanos e máquinas. Saída em JSON (padrão), tabela ou markdown. Conecte facilmente ao jq, scripts ou 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 do app

Crie IAPs consumíveis, não consumíveis e de subscrição não renovável. Defina preços por território a partir dos pontos de preço App Store, gira nome e descrição por idioma e submeta para revisão.

$ 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

Subscrições de renovação automática

Crie grupos de subscrições e níveis (semanal a anual). Gira ofertas introdutórias (trial gratuito, pagamento por uso, pagamento antecipado), metadados por idioma e submeta para revisão.

$ 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

Assinatura de código

Gira a cadeia completa de assinatura: registe Bundle IDs, crie certificados a partir de CSR, registe dispositivos por UDID e crie ou elimine perfis de provisionamento — tudo no terminal.

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

Modo TUI interativo

Execute asc tui para abrir um navegador TUI completo no terminal. Navegue por apps, versões, builds e TestFlight com teclas de seta — sem memorizar comandos.

Início rápido

Funcionando em minutos

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

Instalar via Homebrew

Um comando instala a versão mais recente. Não é necessário Xcode ou cadeia de ferramentas 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
# salvo em ~/.asc/credentials.json

Faça login uma vez, use sempre

Salve sua chave API com asc auth login. As credenciais são armazenadas em ~/.asc/credentials.json — sem variáveis de ambiente por sessão.

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

Comece a gerenciar seus apps

Liste apps, inspecione versões, faça upload de capturas de tela e envie para revisão — tudo do seu terminal ou de um agente de IA.

Habilidades do Agente

Turbine seu agente de IA

Instale mais de 26 habilidades prontas que ensinam seu agente de codificação IA a usar cada comando asc — de uploads a submissões.

$ asc skills install --all

asc-builds-upload

Faça upload de builds IPA/PKG e gerencie a distribuição TestFlight

asc-app-shots

Gere e traduza capturas de tela do App Store com IA

asc-check-readiness

Verificações prévias antes de enviar para revisão

asc-auth

Configure e gerencie credenciais da API do App Store Connect

asc-testflight

Gerencie grupos beta e testadores do TestFlight

asc-release-workflow

Lançamento ponta a ponta: versionar, arquivar, fazer upload, enviar

Mais de 26 habilidades disponíveis — compatível com Claude Code, Cursor, Windsurf e mais

Pronto para experimentar o asc?

Automatize seu workflow no App Store Connect

$ brew install tddworks/tap/asccli

Comunidade

App Wall

Apps reais na App Store publicados por desenvolvedores usando asc CLI.

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

Um comando para enviar seu app e abrir um pull request →

Built for real apps

Sponsors