tddworks/asc-cli

App Store Connect from your terminal & Agents. A Swift CLI for managing your iOS and macOS apps on App Store Connect. Submit versions, manage screenshots, track builds — with full AI-agent support via CAEOAS affordances.

asc‑cli – App Store 命令中心

这是什么 – 一个基于 Swift 的命令行工具，与 Apple 的 App Store Connect API 通信。它让你可以脚本化 iOS/macOS 应用程序的整个生命周期：创建构建、上传二进制文件、管理 TestFlight 测试员、配置应用内购买、编辑元数据，以及拉取销售/分析报告。所有输出默认是 JSON，方便自动化或 AI 代理使用。

主要功能

认证 – 使用 App Store Connect API 密钥登录（asc auth login）。
CAEOAS – 每个 JSON 响应都包含一个 affordances 块，内含可直接运行的 CLI 命令，让下游代理可以发现下一步操作，而无需硬编码命令树。
完整的 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。

tddworks/asc-cli

asc‑cli – App Store 命令中心

相关