오픈소스 · MIT 라이선스

터미널에서
App Store Connect를 관리하세요.

iOS 및 macOS 앱을 App Store Connect에서 관리하는 Swift CLI. 버전 제출, 스크린샷 관리, 빌드 추적 — CAEOAS를 통한 완전한 AI 에이전트 지원.

$ brew install tddworks/tap/asccli
GitHub에서 보기
130+
명령어
CAEOAS
AI 에이전트 지원
MIT
오픈소스
100+
API 엔드포인트
zsh — 80×24

기능

필요한 모든 기능을 갖췄습니다

공식 App Store Connect API 기반으로, 깔끔한 3레이어 아키텍처와 AI 에이전트 워크플로우를 위한 완전한 Affordance 출력을 제공합니다.

AI 에이전트 지원 (CAEOAS)

모든 응답에 affordances 필드로 바로 실행 가능한 다음 명령어가 포함됩니다. 에이전트는 전체 명령 트리를 알 필요 없이 링크만 따라가면 됩니다.

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

완전한 리소스 계층

전체 App Store Connect 리소스 트리 관리: 앱 → 버전 → 현지화 → 스크린샷 세트 → 스크린샷. 빌드와 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

원클릭 심사 제출

단 하나의 명령으로 iOS 또는 macOS 버전을 App Store 심사에 제출합니다. CLI가 복잡한 다단계 심사 제출 흐름을 자동으로 처리합니다.

사전 제출 확인

제출 전에 한 명령으로 모든 검사를 실행하세요. 누락된 빌드, 미설정 가격, 불완전한 현지화를 탐지합니다 — MUST FIX와 SHOULD FIX 심각도로 구분. 모든 검사 통과 시에만 제출 기능이 활성화됩니다.

$ 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)

App Store Connect 웹 UI를 구동하는 비공개 API에 접근합니다. 앱 생성, 전체 앱 목록 조회 등 공개 REST API로는 불가능한 기능을 제공합니다. 브라우저 쿠키 인증으로 추가 설정이 필요 없습니다.

# 키를 한 번만 저장
$ asc app-shots config \
  --gemini-api-key KEY
# PNG를 .asc/app-shots/에 배치 → 실행
$ asc app-shots generate
# 한 번에 현지화
$ asc app-shots translate \
  --to zh --to ja
✓ screen-0.png · 1320×2868
✓ zh/ ja/ ← localized

AI 스크린샷 생성기

Gemini AI로 1320×2868(iPhone 6.9") App Store 스크린샷 생성. asc app-shots translate --to zh --to ja 로 한 번에 현지화. 정확한 크기 보장.

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

버전 현지화

각 언어별 '새로운 기능' 텍스트, 설명, 키워드 및 홍보 URL을 업데이트합니다. 모든 지원 로케일에 대한 완전한 CRUD 작업(목록, 생성, 업데이트)을 지원합니다.

$ 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

스크린샷

모든 화면 크기의 스크린샷 세트를 생성하고 3단계 ASC 업로드 흐름으로 PNG 이미지를 업로드합니다. iPhone, iPad, Mac, 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

앱 미리보기

선택적 썸네일 타임코드와 함께 동영상 미리보기(.mp4, .mov, .m4v)를 업로드합니다. CLI가 예약, 청크 업로드, MD5 확인의 완전한 3단계 업로드 흐름을 처리합니다.

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

앱 정보 현지화

언어별 앱 메타데이터(이름, 부제목, 개인정보 처리방침 URL)를 읽고 씁니다. 모든 버전에 적용되는 앱 수준의 메타데이터로, 버전 현지화와 별도로 관리됩니다.

# 최초 한 번만 설정
$ asc auth login \
  --key-id KEY \
  --private-key-path ~/.asc/Key.p8
✓ ~/.asc/credentials.json에 저장됨
# 이후 환경변수 불필요
$ asc apps list

영구 로그인 인증

asc auth login으로 한 번 로그인하면 인증 정보가 ~/.asc/credentials.json에 저장되어 모든 명령에서 자동으로 사용됩니다. 환경변수 설정이 필요 없습니다.

$ 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

빌드 업로드

5단계 ASC 업로드 흐름으로 IPA/PKG를 업로드합니다: 슬롯 예약, 청크 업로드, MD5 확인, 처리 상태 폴링. 업로드 기록 목록, 조회, 삭제도 지원합니다.

$ 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

베타 그룹과 테스터 관리: 이메일로 추가/제거, CSV로 대량 가져오기/내보내기, 그룹에 빌드 배포, 언어별 새로운 기능 노트 업데이트.

다양한 출력 형식

사람과 기계 모두를 위한 설계. JSON(기본값), 테이블, Markdown 형식으로 출력. jq, 스크립트, AI 에이전트로 손쉽게 파이프 연결.

$ 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

인앱 구매

소모성, 비소모성, 비갱신 구독 IAP를 생성합니다. App Store 가격 포인트에서 지역별 가격을 설정하고, 언어별 이름과 설명을 관리하여 심사를 제출합니다.

$ 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

자동 갱신 구독

구독 그룹과 등급(주간~연간)을 생성합니다. 무료 체험, 사용량 기반 결제, 선불 결제 등 인트로덕토리 오퍼와 언어별 메타데이터를 관리하여 심사를 제출합니다.

$ 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

코드 서명

전체 서명 체인 관리: Bundle ID 등록, CSR에서 인증서 생성, UDID로 기기 등록, 프로비저닝 프로파일 생성 및 삭제 — 모두 터미널에서.

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

대화형 TUI 모드

asc tui를 실행하여 완전한 터미널 UI 브라우저를 엽니다. 방향키로 앱, 버전, 빌드, TestFlight를 탐색 — 명령어를 외울 필요 없이 탐색과 발견에 최적.

빠른 시작

몇 분 만에 시작하기

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

Homebrew로 설치

명령어 하나로 최신 버전 설치. Xcode나 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
# ~/.asc/credentials.json에 저장됨

한 번 로그인, 계속 사용

asc auth login으로 API 키를 저장하세요. 인증 정보는 ~/.asc/credentials.json에 저장되어 매 세션마다 환경변수를 설정할 필요가 없습니다.

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

앱 관리 시작

앱 목록 조회, 버전 확인, 스크린샷 업로드, 심사 제출 — 터미널에서 또는 AI 에이전트를 통해.

에이전트 스킬

AI 에이전트를 강화하세요

26개 이상의 사전 구축 스킬을 설치하여 AI 코딩 에이전트에게 모든 asc 명령어 사용법을 가르치세요 — 업로드부터 제출까지.

$ asc skills install --all

asc-builds-upload

IPA/PKG 빌드 업로드 및 TestFlight 배포 관리

asc-app-shots

AI로 App Store 스크린샷 생성 및 번역

asc-check-readiness

심사 제출 전 사전 점검

asc-auth

App Store Connect API 인증 정보 설정 및 관리

asc-testflight

TestFlight 베타 그룹 및 테스터 관리

asc-release-workflow

엔드투엔드 릴리스: 버전 범프, 아카이브, 업로드, 제출

26개 이상의 스킬 사용 가능 — Claude Code, Cursor, Windsurf 등과 호환

asc를 사용해 보실 준비가 되셨나요?

App Store Connect 워크플로우를 자동화하세요

$ brew install tddworks/tap/asccli
GitHub에서 소스 보기

커뮤니티

앱 쇼케이스

asc CLI를 사용해 App Store에 출시된 실제 앱입니다.

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

한 줄 명령어로 앱을 등록하고 PR 열기 →

Built for real apps

Sponsors