tddworks/asc-cli

asc‑cli – App Store コマンドセンター

これは何か – Apple の App Store Connect API と通信する Swift ベースのコマンドラインツールです。iOS/macOS アプリのライフサイクル全体をスクリプト化できます：ビルドの作成、バイナリのアップロード、TestFlight テスターの管理、アプリ内購入の設定、メタデータの編集、売上/分析レポートの取得。すべての出力はデフォルトで JSON であり、自動化や AI エージェントが簡単に利用できます。

主な機能

• 認証 – App Store Connect API キーでログイン（asc auth login）。
• CAEOAS – 各 JSON レスポンスには、すぐに実行可能な CLI コマンドを含む affordances ブロックが含まれており、下流のエージェントがコマンドツリーをハードコーディングせずに次のアクションを発見できます。
• 完全な App Store ワークフロー – バージョンの作成、ビルドのリンク、事前チェックの実行、レビュー提出、TestFlight グループの管理、スクリーンショット/プレビューのアップロード、価格設定、IAP、サブスクリプション、A/B テストのプロダクトページアセットの設定。
• 拡張可能 – プラグイン、「スキル」、ローカルシミュレーター、組み込みの REST サーバー（asc web‑server）により、CLI を CI パイプラインやカスタムツールに統合できます。
• 出力形式 – JSON（デフォルト）、テーブル、Markdown、またはインタラクティブな TUI（asc tui）。
• Swift パッケージ – 基盤となる ASCKit ライブラリを独自の Swift プロジェクトに埋め込むことができます。

典型的なワークフロー

# 認証
asc auth login --key-id <ID> --issuer-id <ID> --private-key-path ~/.asc/AuthKey_XXXXXX.p8

# アプリを一覧表示し、選択して固定
asc apps list
asc init --app-id <APP_ID>

# 新しいバージョンを作成し、ビルドをアップロード
asc versions create --version-string 2.1.0
asc builds upload --path MyApp.ipa

# 事前チェックを実行し、提出
asc versions check-readiness --version-id v1
asc versions submit --version-id v1

asc versions list から返される JSON には、affordances フィールドに asc versions submit … などのコマンドが含まれており、AI 駆動のリリースボットが自動的に手順を実行できます。

対象読者 – iOS/macOS 開発者、リリースエンジニア、および App Store Connect へのプログラム可能なインターフェースを必要とする CI/CD パイプライン。特に自動化または AI 支援のデプロイワークフローを構築している人向けです。

ライセンス – Apache 2.0。