rudrankriyam / App-Store-Connect-CLI

Unofficial App Store Connect CLI A fast, lightweight, and scriptable CLI for the App Store Connect API. Automate iOS, macOS, tvOS, and visionOS release workflows from your terminal, IDE, or CI/CD pipeline. Table of Contents • asc skills • Sponsors • Quick Start • Troubleshooting • Support • Wall of Apps • Common Workflows • Commands and Reference • Documentation • Contributing • License asc skills Agent Skills for automating workflows including builds, TestFlight, metadata sync, submissions, and signing: https://github.com/rudrankriyam/app-store-connect-cli-skills Sponsors Rork helps you build real mobile apps by chatting with AI, going from idea to phone in minutes and to the App Store in hours. Quick Start If you want to confirm the binary works before configuring authentication: • Install For source builds and contributor setup, see CONTRIBUTING.md. • Authenticate Generate API keys at: https://appstoreconnect.apple.com/access/integrations/api If you are running in CI, a headless shell, or a machine where keychain access is not available, use config-backed auth instead: • Validate auth • First command Output defaults (TTY-aware) chooses a default based on where stdout is connected: • Interactive terminal (TTY): • Non-interactive output (pipes/files/CI): You can still set a global preference: And explicit flags always win: Troubleshooting Homebrew • Refresh Homebrew first: • Check which binary you are running: • Confirm the installed version: • If Homebrew is behind the latest GitHub release, use the install script from Authentication • Validate the active profile: • Run the auth health check: • If keychain access is blocked, retry with or re-run • Use when you want repo-local credentials in Output • defaults to in an interactive terminal and in pipes, files, and CI • Use an explicit format when scripting or sharing repro steps: , , or • Use with JSON when you want readable output in terminals or bug reports • Set a personal default with , but remember always wins Support • Use GitHub Discussions for install help, authentication setup, workflow advice, and "how do I...?" questions • Use GitHub Issues for reproducible bugs and concrete feature requests • See SUPPORT.md for the support policy and bug-report checklist • Before filing an auth or API bug, retry with ; if it is safe to do so, include redacted output from or Wall of Apps See the Wall of Apps → Want to add yours? The command uses your authenticated session to fork the repo and open a pull request that updates . It resolves the public App Store name, URL, and icon from the app ID automatically. For manual entries that are not on the public App Store yet, use with . Use to preview the fork, branch, and PR plan before creating anything. Common Workflows TestFlight feedback and crashes Builds and distribution Release (high-level: validate + attach + submit) Lower-level alternatives (for scripting or partial workflows): Metadata and localization Screenshots and media Signing and bundle IDs Workflow automation Verified local Xcode -> TestFlight workflow See docs/WORKFLOWS.md for a copyable and that use , , , and . Xcode Cloud workflows and build runs Commands and Reference Use built-in help as the source of truth: For full command families, flags, and discovery patterns, see: • docs/COMMANDS.md Documentation • docs/CI_CD.md - CI/CD integration guides (GitHub Actions, GitLab, Bitrise, CircleCI) • docs/COMMANDS.md - Command families and reference navigation • docs/WORKFLOWS.md - Reusable workflow patterns, including local Xcode to TestFlight • docs/API_NOTES.md - API quirks and behaviors • docs/CONTRIBUTING.md - CLI development and testing notes • docs/TESTING.md - Testing patterns and conventions • docs/openapi/README.md - Offline OpenAPI snapshot + update flow • CONTRIBUTING.md - Contribution guide Acknowledgements Local screenshot framing uses Koubou (pinned to ) for deterministic device-frame rendering. GitHub: https://github.com/bitomule/koubou Simulator UI automation for screenshot capture and interactions uses AXe CLI. GitHub: https://github.com/cameroncooke/AXe Contributing Contributions are welcome. See CONTRIBUTING.md for details. License MIT License - see LICENSE for details. Author Rudrank Riyam Star History --- Built with Codex & Cursor using GPT-5.3-Codex and GPT-5.4 This project is an independent, unofficial tool and is not affiliated with, endorsed by, or sponsored by Apple Inc. App Store Connect, TestFlight, Xcode Cloud, and Apple are trademarks of Apple Inc., registered in the U.S. and other countries.