{"id":13995296,"url":"https://github.com/ittybittyapps/appstoreconnect-cli","last_synced_at":"2025-07-22T21:32:30.547Z","repository":{"id":45205231,"uuid":"245960079","full_name":"ittybittyapps/appstoreconnect-cli","owner":"ittybittyapps","description":"An easy to use command-line tool for interacting with the Apple AppStore Connect API","archived":false,"fork":false,"pushed_at":"2022-11-01T05:31:40.000Z","size":6246,"stargazers_count":173,"open_issues_count":20,"forks_count":17,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-08-10T14:19:00.358Z","etag":null,"topics":["apple","appstoreconnect","cli","client","developer-tools","macos","mobile","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ittybittyapps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-09T06:28:04.000Z","updated_at":"2024-07-27T08:08:27.000Z","dependencies_parsed_at":"2023-01-21T02:49:37.182Z","dependency_job_id":null,"html_url":"https://github.com/ittybittyapps/appstoreconnect-cli","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ittybittyapps%2Fappstoreconnect-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ittybittyapps%2Fappstoreconnect-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ittybittyapps%2Fappstoreconnect-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ittybittyapps%2Fappstoreconnect-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ittybittyapps","download_url":"https://codeload.github.com/ittybittyapps/appstoreconnect-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227177888,"owners_count":17743194,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","appstoreconnect","cli","client","developer-tools","macos","mobile","swift"],"created_at":"2024-08-09T14:03:20.371Z","updated_at":"2024-11-29T17:31:25.124Z","avatar_url":"https://github.com/ittybittyapps.png","language":"Swift","readme":"![App Store Connect CLI - Interact with the App Store Connect API from the command line.](.github/logo.png)\n# AppStoreConnect CLI\n\nAn easy to use command-line tool for interacting with the Apple AppStore Connect API.\n\n[![MIT License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)][license]\n[![PRs Welcome!](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)][contributing]\n![Build and Test](https://github.com/ittybittyapps/appstoreconnect-cli/workflows/Build%20and%20Test/badge.svg)\n\nAppStoreConnect CLI lets you interact with the AppStore Connect from the command line.\n\n- Manage Users and access.\n- Manage TestFlight Users, Beta Groups, and Builds.\n- Manage Devices, Profiles and Bundle IDs.\n- Manage Certificates.\n- Download reports.\n\n⚠️ **Note:** _AppStoreConnect CLI_ is under heavy development and not all features are complete.\n\n## Installation\n\n### Using [Homebrew](http://brew.sh/):\n\n```sh\nbrew tap ittybittyapps/appstoreconnect-cli\nbrew install --HEAD appstoreconnect-cli\n```\n\n### Using [Mint](https://github.com/yonaskolb/mint):\n\n```sh\nmint install ittybittyapps/appstoreconnect-cli\n```\n\n### TODO: Using a pre-built binary:\n\nYou can also install AppStoreConnect-CLI by downloading binaries from the\n[latest GitHub release](https://github.com/ittybittyapps/appstoreconnect-cli/releases/latest).\n\n### Using Swift Package Manager:\n\n#### On the Command Line\n\n```sh\ngit clone https://github.com/ittybittyapps/appstoreconnect-cli.git\ncd appstoreconnect-cli\nswift run asc\n```\n\n#### As a Dependency\n\nAdd the following to your `Package.swift` file's dependencies:\n\n```swift\n.package(url: \"https://github.com/ittybittyapps/appstoreconnect-cli.git\", .branch(\"master\")),\n```\n\nThen you can run:\n```sh\nswift run asc\n```\n\n## Road to 1.0\n\n⚠️ Until 1.0 is reached, minor versions will be breaking.\n\n## Usage\n\nRun `asc --help` to see usage instructions.\n\n```\n$ swift run asc --help\nOVERVIEW: A utility for interacting with the AppStore Connect API.\n\nUSAGE: asc \u003csubcommand\u003e\n\nOPTIONS:\n  -h, --help              Show help information.\n\nSUBCOMMANDS:\n  bundle-ids              Manage the bundle IDs that uniquely identify your apps.\n  certificates            Create, download, and revoke signing certificates for app development and distribution.\n  devices                 Register devices for development and testing.\n  profiles                Create, delete, and download provisioning profiles that enable app installations for development and distribution.\n  reports                 Download your sales and financial reports.\n  testflight              Manage your beta testing program, including beta testers and groups, apps, and builds.\n  users                   Manage users on your App Store Connect team.\n```\n\n## Authentication\n\n_AppStoreConnect CLI_ requires the use of an AppStore Connect API Key. See the [Apple documentation][docs-api-key] for more details on how to create these keys.\n\nWhen using _AppStoreConnect CLI_ commands you need to specify the API Key Issuer and API Key ID. This can be done via the `--api-issuer` and `--api-key-id` command line options or `APPSTORE_CONNECT_ISSUER_ID` and `APPSTORE_CONNECT_API_KEY_ID` environment variables respectively.\n\nThe API private key is expected to be named `AuthKey_\u003capi-key-id\u003e.p8` and located in one of the following directories:\n\n- `./private_keys`\n- `~/private_keys`\n- `~/.private_keys`\n- `~/.appstoreconnect/private_keys`\n\nThe API private key can also be stored in the environment variable `APPSTORE_CONNECT_API_KEY`.\n\n## Contribute to _AppStoreConnect CLI_\n\nRead the [Contribution Guide][contributing] for more information on how to contribute to _AppStoreConnect CLI_.\n\n## Code of Conduct\n\nHelp us keep our project diverse, open and inclusive. Please read and follow our [Code of Conduct][code-of-conduct].\n\n## License\n\nThis project is licensed under the terms of the MIT license. See the [LICENSE][license] file.\n\n\u003e This project is in no way affiliated with [Apple Inc][apple]. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. _AppStoreConnect CLI_ runs on your own computer or server and does not communicate with any service other than the [Apple AppStore Connect API][appstore-connect-api]. You are responsible for how you use _AppStoreConnect CLI_.\n\n## Acknowledgements\n\nWe use the following Swift Packages in `appstoreconnect-cli`.  We are very grateful to their authors.\n\n- [AppStoreConnect Swift SDK][appstoreconnect-swift-sdk] by [@AvdLee][avdlee]\n- [CodableCSV][codablecsv] by [@dehesa][dehesa]\n- [Files][files] by [@johnsundell][johnsundell]\n- [Swift Argument Parser][argument-parser] by [Apple][apple-github]\n- [SwiftyTextTable][text-table] by [@scottrhoyt][scottrhoyt]\n- [Yams][yams] by [@jpsim][jpsim]\n\n\n[docs-api-key]: https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api\n[license]: LICENSE\n[contributing]: CONTRIBUTING.md\n[code-of-conduct]: CODE_OF_CONDUCT.md\n[apple]: https://apple.com\n[appstore-connect-api]: https://developer.apple.com/app-store-connect/api/\n[appstoreconnect-swift-sdk]: https://github.com/AvdLee/appstoreconnect-swift-sdk\n[avdlee]: https://github.com/AvdLee\n[files]: https://github.com/johnsundell/files.git\n[johnsundell]: https://github.com/johnsundell\n[argument-parser]: https://github.com/apple/swift-argument-parser\n[apple-github]: https://github.com/apple\n[yams]: https://github.com/jpsim/Yams.git\n[jpsim]: https://github.com/jpsim\n[text-table]: https://github.com/scottrhoyt/SwiftyTextTable.git\n[scottrhoyt]: https://github.com/scottrhoyt \n[codablecsv]: https://github.com/dehesa/CodableCSV\n[dehesa]: https://github.com/dehesa\n","funding_links":[],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fittybittyapps%2Fappstoreconnect-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fittybittyapps%2Fappstoreconnect-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fittybittyapps%2Fappstoreconnect-cli/lists"}