Changelog
September 2026 · August 2026 · July 2026 · June 2026 · May 2026 · April 2026 · March 2026 · February 2026 · January 2026
September 2026
5.1.0 (2026-09-08)
New features
asc web removed-apps list,asc web api-keys list, andasc web api-keys viewaccept--session-from-envfor CI reads.--session-from-envreads the versionedASC_WEB_SESSIONbundle in memory, validates the Apple Account identity, and leaves the session cache and keychain untouched.- Other commands reject
--session-from-env; provider selectors and two-factor overrides are also rejected in this mode.
Improvements and fixes
- Review-draft create treats a successful response with omitted
dataas an inconclusive preflight and stops before writing. - Review-draft delete reports an unverified result when the response omits
data, while explicitdata: nulland relationship 404 responses still prove absence. - Individual API-key P8 files are staged through the private-file path before secret bytes are written, protecting them from inherited macOS ACLs.
- Individual-key publication keeps atomic no-replace behavior and preserves recovery artifacts when the destination directory grants inherited access.
- Interactive web login renews its request budget after credential retrieval, two-factor authentication, and keychain waits, so provider selection and session persistence do not inherit an expired deadline.
- Caller cancellation and caller-owned deadlines remain effective when web login renews its internal request budget.
- The installer refreshes the pinned ASC skills pack.
- Help and documentation no longer show the command surface as experimental; operational limits, confirmations, and deprecation guidance remain.
5.0.0 (2026-09-06)
New features
asc capabilitiesinventories supported web-session workflows alongside public API commands.
Local validation, Xcode, and screenshot workflows
asc validatewarns about placeholder text, short app names, empty or non-canonical keyword segments, repeated phrases, and terms duplicated in an app name or subtitle.--strictturns content-quality warnings into blockers.asc validate --check-urlsperforms bounded, read-only checks for support, marketing, privacy-policy, and privacy-choices URLs.- URL checks reject private destinations, cap redirects, disable proxies, avoid response bodies, and redact URLs and network details from findings.
asc xcode doctorreports the selected developer directory, Xcode and SDK availability,xcodebuild,xcrun, beta status, and overall result.asc xcode doctorsupports JSON, table, and Markdown output.asc xcode doctordoes not switchxcode-select, install software, invokesudo, or contact App Store Connect.asc xcode testsupportstest,build-for-testing, andtest-without-buildingwith explicit destinations, result-bundle paths, and bounded cancellation.- Local Xcode tests safely discover
.xctestrunartifacts, preserve ordinary Xcode exit statuses, and keep diagnostics on stderr. asc xcode testemits JSON, table, Markdown, or JUnit results with bounded test failures.asc xcode installvalidates a signed IPA, its profile, and one exact connected physical device before invoking Xcodedevicectl.- The install workflow materializes one
Payload/*.appbundle in a private bounded directory and verifies its bundle identifier, version, and build afterward. - Install diagnostics redact paths, identifiers, tool output, and internal causes; the source IPA is never overwritten.
asc screenshots matrixexpands a JSON plan across devices, locales, appearances, and content variants with bounded concurrency and retries.- Screenshot matrices publish raw captures, optional framed artifacts, and offline HTML/JSON review reports through rooted, no-follow, atomic file handling.
- Screenshot matrix execution is local and does not upload artifacts to App Store Connect.
Signing, certificates, and notarization
asc signing sync push --targets-filesynchronizes an app and embedded targets from a strict manifest with per-target and aggregate results.asc signing sync pullselects one bundle ID or a targets manifest, requires complete resolution before writing, and keeps full-repository pulls when no selector is supplied.asc signing sync rotate-passwordvalidates every encrypted artifact, rewraps identities and metadata, verifies the replacement password, and publishes one commit without rewriting Git history.- Password rotation stops before publication when the current password is wrong or an encrypted artifact is corrupt.
- Signing sync accepts protected PKCS#12 or PEM identities for
MAC_APP_DIRECTandMAC_CATALYST_APP_DIRECT. - Direct-distribution signing checks signed macOS and all-device claims and the associated Developer ID Application certificate before Git publication.
asc signing keychain installplaces one verified identity in a new dedicated macOS keychain, optionally adds it to the search list, and leaves the default keychain unchanged.- Dedicated-keychain installation validates permissions, certificate binding, team, and optional fingerprint, then rolls back the keychain and search-list change after a failed verification.
asc certificates exportvalidates an Apple push certificate, matching unencrypted RSA or EC private key, and optional CSR before writing a password-protected PKCS#12 identity.asc xcode signing planresolves direct, inherited, and xcconfig settings into a source-bound plan;applyrequires its hash and commits staged edits transactionally.asc signing resignvalidates profiles, teams, certificates, entitlements, nested code, and archive metadata before producing a new IPA through create-only atomic output.- Re-signing signs leaf code before containers, avoids
codesign --deep, verifies the repacked archive, and never overwrites the input or an existing output. --rebase-team-claimsoptionally rewrites allowlisted keychain access-group and ubiquitous KVS namespaces, rejecting ambiguous mappings and recording deterministic entitlement changes.asc notarization staple --file PATH --confirmstaples a macOS artifact and validates its ticket;asc notarization validate --file PATHperforms the read-only check.- Notarization commands use bounded diagnostics and rooted no-follow paths, and reject direct ZIP inputs.
Web authentication, API keys, and Developer Portal coverage
asc web auth exportwrites a versionedasc-web-sessionbundle;asc web auth importloads it from a file or--from-envand can validate it with--validate.- Web-session import checks cookie origins and expiration before atomically updating the selected cache; secret values stay out of output.
- Concurrent web-session writes use serialized cache generations, preventing cleanup from deleting a newer or unrelated session.
- Bundle IDs, App Groups, and agreements share Developer Portal CSRF refresh, same-origin, cookie-persistence, and team-selection behavior.
--developer-teamaccepts a team ID or exact name; ambiguous multi-team accounts fail closed instead of selecting a team silently.asc web api-keys listandviewexpose team and individual key metadata without printing private key material.- Team API-key creation validates PKCS#8 P8 input and accepts case-insensitive
--rolevalues. asc web api-keys create-individualgenerates a P-256 private key locally, registers only its public key, and saves a recoverableApiKey_<KEY_ID>.p8file.- Individual-key creation preserves existing destination files and retains the local artifact after an uncertain remote result.
- API-key revocation handles team and individual keys with a type-specific preflight and post-state verification.
- Developer Portal commands read iOS and macOS Bundle IDs and support disabling private-cloud-compute capabilities.
- Developer Portal commands manage Services IDs.
- Developer Portal commands list visible and hidden iCloud containers.
- Website Push IDs support verified view, create, and delete operations.
asc web app-groupsgains exact-set, unassign, and delete operations; deletes stop while references remain, and changed App IDs warn that profiles need regeneration.asc web agreements acceptaccepts several named agreements in one confirmed request and verifies every requested status afterward.asc web agreements downloadsaves one agreement with HTTPS same-host checks, atomic publication, a size limit, and no signed URL in output.asc web apps create --access full|limitedconfigures full or selected limited app visibility after creation; limited access requires at least one user.- Omitting
--accessfrom app creation preserves the historical request body.
App, review, privacy, tax, and subscription workflows
asc web apps deletepreflights observable eligibility and verifies server state after deletion before reporting success.- App distribution commands read distribution method and set public or private distribution with readback verification.
- App commands read status history and app transfer status.
- Custom-distribution commands list Apple Account recipients.
- Removed apps can be restored with explicit full or limited access.
asc versions update --version-id VERSION_ID --downloadable true|falsemanages version availability through the public API; settingfalserequires--confirm.- Application and IAP tax-category commands validate catalog choices and resource identity before setting or clearing explicit categories.
- Tax workflows generate and download one eligible Transaction Tax report.
- Medical-device declarations support affirmative
EEA,GBR, andUSAdeclarations and a detailed regional JSON form. asc web reviewreads app-scoped Resolution Center threads and unsent drafts.- App Review replies send one verified text message; attachment uploads remain unsupported.
asc web review drafts create|update|deletemanages unsent drafts without sending messages or uploading attachments.asc subscriptions pricing plan-availability show|setreads and updates complete territory sets, including the territories needed by monthly-commitment setup.asc web xcode-cloud workflows listreads workflows for a product through a web session;asc xcode-cloud workflows duplicatecopies an existing workflow through the public API.- Web Xcode Cloud commands manage the persistent next build number and custom version-alias lifecycle.
- Web Xcode Cloud commands inspect private SCM provider connection status.
asc web sandbox deleteprotects family members and incomplete snapshots, rejects missing or duplicate IDs, and verifies every requested tester's absence after deletion.
Improvements and fixes
- Uncertain timeout or server-error responses for Xcode Cloud aliases, Services IDs, and app distribution use readback where available; the CLI never retries these mutations automatically.
- Invalid flag values now consistently return usage exit code
2across analytics, Game Center, encryption, IAP, subscriptions, pricing, TestFlight, webhooks, apps, builds, reviews, and Xcode Cloud. asc searchprioritizes release-dashboard status intent and routes remaining release follow-ups to the relevant command family.- Web login retries a fresh login after a post-two-factor
401, and request deadlines begin after interactive authentication. - Web-session compare-and-delete is atomic and backend-scoped; cache generations prevent stale cleanup from deleting newer sessions.
- Signing writes protect inherited entitlement inputs, preserve special permission bits, detect ACL and extended-attribute drift, and preflight IPA central directories.
- Xcode signing bounds source graphs, blocks changed shared fallbacks, and preserves xcconfig inheritance and comment state across edits.
- Re-signing preserves container entitlements and traverses preserved trees through rooted handles, including nested App Clip relationship claims.
- TestFlight readers decode object-form app-tester dimensions, paginate review readers, retain included rejection context, and document app-endpoint field conflicts.
- Privacy workflows fail closed on unknown publication state or unrepresentable remote usage values and preserve
DATA_NOT_COLLECTEDduring pull and plan round trips. - Privacy planning handles stale catalog tokens and failures partway through a sequence.
- Monthly-commitment price writes read back the resulting prices so a partial or stale response cannot be reported as success.
- App Clip capability sync requires
--confirm, compares the current graph, skips no-op writes, and preserves unrelated relationships. - Certificate listing validates
--certificate-typeand drops invalid types; app tax-category reads reject mismatched resource IDs.
Breaking changes
- 5.0 removes the 4.x CLI-side deprecation windows; former warning paths now fail with usage errors.
- The new web, Xcode, and signing command families ship with experimental labels; 5.1 removes those labels without changing their behavior.
asc auth logoutrequires--confirmbefore credential access; missing confirmation returns usage exit code2.asc game-center groups achievements setandasc game-center groups leaderboards setrequire--confirmbefore network access.asc game-center leaderboard-sets members setandasc game-center leaderboard-sets v2 members setalso require--confirm; missing confirmation returns usage exit code2.--deviceonasc signing fetchandasc signing sync pushrequires--create-missing.asc signing sync push|pullno longer accepts inline--passwordorASC_MATCH_PASSWORD; use--password-fileorASC_SIGNING_SYNC_PASSWORD.- Product-scoped
asc iap localizations,asc iap images, andasc iap submitare removed; use the corresponding version-scoped commands. - Product-scoped
asc subscriptions localizations,asc subscriptions images, andasc subscriptions groups localizationsare removed; use the corresponding... versions ...commands. - Product-scoped subscription review submitters are removed; select IAP or subscription version resources with
asc review items add. - Deprecated build
--idselectors and--buildaliases are removed where--build-idis canonical. --newest,--app-id, and deprecated app, version, info, bundle, localization, screenshot, and subscription aliases are removed. Consult the 5.0 command-specific--helpfor replacements.- Replace
--two-factor-codewith--two-factor-code-commandorASC_WEB_2FA_CODE_COMMAND; negative-keyword views no longer accept--keyword. - The undocumented
--nameand--ref-namespellings retained byiap setupandsubscriptions setupremain available. - The challenge relationship setter, advanced-experience image delete shim, and Game Center detail pagination flags are removed.
--available-in-new-territories,--external-testing, and--challenge-enabledno longer work.--territory ALLis rejected; use--all-territories.ASC_IRIS_SESSION_CACHEandASC_IRIS_SESSION_CACHE_DIRare no longer read; useASC_WEB_SESSION_CACHEandASC_WEB_SESSION_CACHE_DIR. The old IRIS cache is not imported.- App-scoped
--build-numberqueries require an explicit--platform, for exampleasc builds info --app APP_ID --build-number 42 --platform IOS. - Read version availability with
asc versions view --version-id VERSION_ID; set it withasc versions update --version-id VERSION_ID --downloadable true|false, adding--confirmforfalse. - The Migrate to 5.0 guide includes the complete command table and upgrade checklist.
August 2026
4.11.0 (2026-08-29)
New features
asc validate --deepchecks App Privacy publication, pending agreements, and first subscription attachment through an existing cached Apple web session.- Deep validation remains read-only; it never starts login, opens Keychain, accepts agreements, publishes privacy answers, or attaches subscriptions.
--apple-idselects the cached Apple Account, while--strictturns missing-session and other warning findings into blocking failures.- Deep results preserve successful public checks when one private endpoint fails, and classify each result as
passed,blocked,unverified, ornotApplicable. - The subscription check distinguishes an approved first subscription from a ready but unattached one, and leaves terminal versions as
notApplicable. - Incomplete pricing evidence remains
unverified, so validation does not infer that an app is free or invent a Paid Apps Agreement blocker.
Improvements and fixes
- Slack validation notifications keep diagnostics concise while retaining the finding that explains why validation failed.
- Snitch telemetry classifies descriptions as leaf calls, keeping emitted call shapes consistent for telemetry consumers.
- Command documentation generation preserves help output when the Go build cache starts cold.
Community and maintenance
- Wall of Apps added TapTape and Somilo.
- AWS SDK, Smithy, AWS credentials, AWS S3, and Bitrise utility dependencies received routine updates.
4.10.0 (2026-08-27)
New features
asc versions list --latestreduces results to the newest version for each platform.- Product-page listings expose documented query controls for filtering, sorting, fields, includes, and pagination.
- App-event listings expose documented query controls, allowing callers to select the event data they need.
- IAP v2 listings expose documented list filters, fields, includes, sorting, and pagination controls.
- Bundle ID listings expose documented filters, fields, includes, sorting, and pagination controls.
- Certificate listings expose documented filters, fields, includes, sorting, and pagination controls.
- Provisioning-profile listings expose documented filters, fields, includes, sorting, and pagination controls.
- Subscription price listings expose documented filters, fields, includes, sorting, and pagination controls.
- TestFlight beta-group listings expose documented query controls for group discovery and filtering.
- TestFlight tester listings expose sort, include, and invite-type controls.
- User listings expose documented query controls for filtering, fields, includes, sorting, and pagination.
- Xcode Cloud product listings expose documented CI product query controls.
- TestFlight group creation exposes controls for creating internal and external groups.
- Shell completion now includes nested commands and their flags.
- Metadata validation can fetch each unique URL with
--check-urls, using bounded concurrency and reporting URL findings as warnings. - Metadata validation flags placeholder copy in names, subtitles, descriptions, keywords, promotional text, and release notes.
- Validation reports screenshot sets that exceed Apple's ten-screenshot cap.
- Analytics accepts missing sales reports as an explicit condition instead of failing an otherwise usable report set.
Improvements and fixes
- JSON decoding preserves whether sparse resource attributes were absent or explicitly present as
null. - Screenshot collection reads paginate complete collections instead of stopping at the first page.
- Analytics report reads follow continuation URLs, preserving multi-page report output.
- Signing fetch detects pagination cycles and stops instead of looping indefinitely.
- Upload rejects zero-length asset operations before starting an upload.
- Terminal usage diagnostics are sanitized, list validation failures use usage classification, and known flag parse errors stay concise.
- Metadata pagination deadline coverage and Windows telemetry timing tests are more stable.
Community and maintenance
- Wall of Apps added Ordsnok, Snoop for words, and takt, car glance.
- Routine dependency, test, and release maintenance changes are recorded in the release comparison.
4.9.4 (2026-08-26)
Improvements and fixes
- Xcode commands accept project paths with trailing separators.
- App Clip mutations reject repeated comma-separated flags instead of accepting ambiguous input.
- Published-app audits preserve results collected before a later app fails.
- Replacing a user's visible app list requires confirmation.
- Stored profile names are normalized consistently during authentication lookup.
4.9.3 (2026-08-26)
Improvements and fixes
- Subscription price-point streaming validates output flags before starting work.
- Ratings histogram requests honor cancellation promptly.
- Report output rejects symlinked parent paths before writing files.
- Game Center relationship replacement requires confirmation.
- TestFlight tester metric payloads survive the command's processing path.
- Encryption commands reject repeated build IDs.
Community
- Wall of Apps added Otis, A friend to your stocks.
4.9.2 (2026-08-25)
Improvements and fixes
- Public App Store reads cap oversized
Retry-Aftervalues, preventing one response from delaying a command without bound. - Sandbox list filters survive page traversal.
- Subscription setup price mutations reconcile their result with the selected price.
- Build listings reject filters combined with
--next, because the continuation URL already contains the original query. - Known flag parse errors stay short and actionable.
- Web app creation explains the missing-company-name case.
Documentation and maintainer workflows
- Documentation records that the app-scoped builds endpoint can hide the latest build.
- Maintainer guidance personalizes Wall approvals and records the protected-merge cycle.
Community
- Wall of Apps added Quit Caffeine, Focus & Streak, Baby Sleep Sounds, MultiPods Audio, QELM, and Convusic.
4.9.1 (2026-08-24)
Improvements and fixes
- Build upload failures include actionable context for diagnosing the rejected artifact.
- Post-upload TestFlight notes failures are recoverable after a successful build upload.
- Pre-release version matching treats
X.YandX.Y.0as equivalent. - The most frequently missed required flags receive clearer guidance.
- Remaining high-frequency parameter failures use the correct usage-error classification.
- Agreement-blocked HTTP 403 responses explain the agreement state that requires action.
- Preview uploads keep a stable order and report partial results when one item fails.
- Public App Store reads retry rate-limited responses.
Documentation and tests
- Root help teaches the discovery loop for finding commands, flags, and examples.
- Concurrency-sensitive tests share an off-test-goroutine assertion helper.
- Pricing tests use fixtures that match merged availability behavior.
4.9.0 (2026-08-23)
New features
asc optimize keywords rankevaluates keyword rank evidence for a selected app, platform, country, and keyword set.asc optimize search plancombines official Apple Ads evidence with App Store metadata into a read-only review plan.- Search planning keeps popularity, impression share, paid conversions, and metadata coverage as separate evidence sources.
- Search planning writes review-only metadata, exact-keyword, and negative-keyword files when
--out-diris provided. - Search planning suppresses absence-based recommendations when required evidence is unavailable.
asc pricing availability platformsreports platform availability before an app-wide availability mutation.- App-wide remove-from-sale checks whether another platform would remain exposed before changing availability.
- App version view can resolve a version using app and version selectors.
- TestFlight tester removal can wait for completion, and tester exports can filter names.
- Game Center relationship removal requires
--confirm. - The age-rating audit covers the September 2026 social-media response changes.
- Web commands report agreement status and provide an agreement-acceptance operation.
- Subscription setup can derive localized prices from another subscription.
Improvements and fixes
- Metadata validation catches push-time metadata rejections offline, before the network request.
4.8.0 (2026-08-22)
New features
asc builds listexposes the documented/v1/buildsquery surface.- Device registration accepts validated TSV files.
- Localizations can update directly by resource ID.
- Categories support
--nextand--paginatefor controlled traversal. - App listings can sort by SKU and filter by version or review-submission state.
- Xcode Cloud artifact listings include artifacts from every run action.
asc xcode-cloud doctordiagnoses a build run and can save its logs.asc xcode-cloud run --doctor --waitdiagnoses a waited build run.- Unknown subcommands suggest common tasks that may match the requested path.
- Auth logout stages confirmation before deleting credentials.
Improvements and fixes
- Snitch redacts credentials before reporting diagnostics.
- System status accepts completed incidents.
- Analytics warns when report output is truncated.
- Auth doctor validates private keys supplied through the environment.
- Auth status reports credential environment precedence.
- Authentication documentation explains the same credential precedence.
- Metadata errors provide targeted flag recovery guidance.
- Metadata required-input errors remain concise.
- Xcode Cloud status accepts deprecated
--idduring its compatibility window; new scripts should use--run-id.
Community and maintenance
- Wall of Apps added Sunrise Sunset Time SolarWatch, Elite Soccer Tactic Board, and DuoCam Multicam Video Camera.
- AWS configuration, Go crypto, and Bitrise utility dependencies received routine updates.
- Maintainer documentation received proportional validation and faster skill workflows.
4.7.1 (2026-08-21)
Improvements and fixes
- Video-preview uploads preflight set capacity before reserving upload work.
- Continuation requests reject query flags that their URLs would discard.
- Unsupported output formats report valid enum values.
- Bundle ID patch attributes are sanitized before the Web mutation.
- Single-territory introductory offers honor
--dry-run. - Search prioritizes precise command paths when suggesting recovery.
- Misplaced global flags receive a targeted diagnostic.
- Help examples use first-party command paths.
- Versions group help includes worked examples.
- Subscription localization selectors use clearer flag ergonomics.
Tests and compatibility
- The tvOS ranking test forbids score ordering where the platform does not support it.
4.7.0 (2026-08-21)
New features
- Screenshots can be listed by version and locale.
- Localizations and versions expose
--includefor related resources. - Reviews accept multiple
--starsvalues and version-scoped filters. - Status exposes the latest build's internal state and expiry.
- Authentication detects swapped key and issuer IDs before the API returns a 401.
Improvements and fixes
- Asset upload parts retry transient failures.
- Long build waits survive transient errors without abandoning the wait immediately.
- Mutating requests retry rate limits while honoring a bounded
Retry-After. - Images are rejected when detected format contradicts the file extension.
- Screenshot downloads preserve unchanged files.
- Screenshot workflows wait for checksum settlement before proceeding.
- Screenshot capacity failures explain the recovery action.
- App-scoped TestFlight group filters use the documented
/v1/betaGroupsendpoint. - Explicitly requested help prints to stdout.
--build-idis the canonical build selector.
4.6.1 (2026-08-20)
Improvements and fixes
- JWT and Apple Ads client secrets backdate issued-at times to absorb small client clock differences.
- Build release notes are validated before the API request.
- Positional bundle-ID mutation arguments are rejected before side effects.
- Repeated comma-separated flags are rejected on nominations, profiles, and win-back offers.
- Version creation rejects repeated copy-field flags.
- Apple Ads optimization pagination remains bounded.
- Query handling follows the documented schema contract.
- The obsolete Migrate to 1.0 guide was retired.
Community
- Wall of Apps added Secure Storage: Private Vault and Ring Widget.
4.6.0 (2026-08-19)
New features
asc system-statusreports Apple Developer incidents and their current state.- TestFlight notes can be set as soon as builds appear.
- IPA uploads detect the platform declared by the artifact.
Improvements and fixes
- Unsafe build artifacts are rejected before an upload reservation is created.
4.5.0 (2026-08-18)
New features
asc apps publishedaudits account apps for published territory coverage and reports each published app's territory count.asc apps public rankreports platform-aware public App Store search rank.asc pricing availability remove-from-saleperforms a verified app-wide remove-from-sale operation.- TestFlight tester lookup reports truncation and keeps a stable output contract for scripts and agents.
Documentation and community
- The README star-history chart was removed.
- Wall of Apps added Wander: Markdown Editor.
4.4.4 (2026-08-18)
New features
asc optimize search plancombines official Apple Ads Platform evidence with App Store metadata into a read-only review plan.- Search plans preserve popularity, impression share, paid outcomes, and metadata coverage as separate evidence sources.
- Search plans write review-only metadata, exact-keyword, and negative-keyword files under
--out-dir. - TestFlight beta testers can be added to multiple groups in one operation.
- TestFlight beta tester removal requires
--confirm.
Improvements and fixes
- Repeated comma-separated flags on mutating commands are rejected.
- Availability bulk edits preserve completed work when one operation fails.
- The golangci-lint cache stays inside the checkout for repeatable builds.
Community
- Wall of Apps added Aanvi: Baby Memory Book.
4.4.3 (2026-08-16)
New features
- Diagnostics carry structured metadata and codes across high-impact CLI failures.
- Review findings, screenshot validation, TestFlight validation, and submit preflight use structured diagnostic output.
- Raw TestFlight validation diagnostics remain available for callers that need provider detail.
- Apple Ads help includes first-run remediation, stdin payload guidance, and starter examples.
Improvements and fixes
- Search Term Popularity sorting follows the Apple Ads Platform API order.
- TestFlight notifications are idempotent.
- TestFlight period-validation diagnostics are preserved through failure reporting.
- Review submission requests include the
appStoreVersionrelationship.
Community
- Wall of Apps added oh? daily home screen widget, HowHigh, ReShoot, and StartUp Business: Tycoon Sim.
4.4.2 (2026-08-15)
Improvements and fixes
- Xcode export preflight tests no longer depend on the host Xcode installation.
- Review submission item requests include the
appStoreVersionrelationship. - Root filesystem handling supports restricted working directories.
4.4.1 (2026-08-15)
Improvements and fixes
- Apple Ads keyword query selectors are checked against Platform API filters.
- Legacy fields are rejected across Platform API v1 queries instead of being sent silently.
4.4.0 (2026-08-15)
New features
- Apple Ads Platform API v1 foundation adds the transport, account context, authentication, and base resource commands.
- Platform v1 campaign resources are available under direct
asc adscommand paths. - Platform v1 Maps and asset resources are available under direct
asc adscommand paths. - Platform v1 reports and optimization resources are available under direct
asc adscommand paths.
Breaking changes and migration
- Campaign Management API v5 is deprecated; direct
asc adsuses Platform v1, while legacy commands move underasc ads v5.
Community
- Wall of Apps added P2P View.
4.3.0 (2026-08-14)
New features
- Xcode export supports
release-testingbuilds for distribution workflows. - Developer Portal App Groups can be managed through Web commands.
- App Group mutations include safety checks before changing shared identifiers.
- Signing can reconcile ad hoc profiles and run commands in isolated signing environments.
- Signing sync can normalize and store private identities for later pulls and CI workers.
asc distribute inspectvalidates an IPA without wholesale extraction and reports app, profile, certificate, and device facts.asc distribute preparewrites a deterministic verified bundle withbundle.jsonandpayload/app.ipa.asc distribute publishpublishes verified install links through a caller-owned S3-compatible endpoint.asc distribute plan,apply,resume,status, andverifycompose resumable ad hoc installation stages.- Distribution supports separate artifact roots for the bundle, manifest, generated page, and receipt.
Improvements and fixes
- Analytics download units exclude redownloads and updates.
- Builds reject unexpected
add-groupsarguments. - Dependency updates cover Go modules used by text processing, PKCS#12 handling, and workflow tooling.
Community
- Wall of Apps added Sleep Analysis, Lunomia, hora Calendar, and Trailbot: MTB Trail Conditions.
4.2.0 (2026-08-13)
New features
asc builds groupslists the TestFlight groups containing a selected build.asc apps renameprovides a direct command for changing an app's name.- Review submissions can be listed through the nested
review submissions listcommand.
Improvements and fixes
- Direct Claude child sessions are distinguished in session telemetry.
- Public storefront failures retain their HTTP status context.
- Unknown commands stay concise and common command-path mistakes receive recovery guidance.
- Introductory-offer creation requires a territory; the
ALLalias is deprecated.
4.1.0 (2026-08-12)
Improvements and fixes
- Migrate to 4.0 import-path guidance now matches the command's checked behavior.
- Screenshot upload help explains selector requirements before an upload is attempted.
- Key-type failures retain their parameter, and missing versions classify as not found.
- Metadata apply failures preserve their original failure classification.
- Subscription availability resolves territories from the subscription itself.
- Documentation explains how to discover required resource IDs.
- Removed Review item detail commands guide users to the list command.
- Managed Xcode export passthrough arguments are rejected instead of accepted and ignored.
Community
- Wall of Apps added Pebbles: Tax & Visa Tracker and SAO: Luxury Hotel Journal.
4.0.0 (2026-08-11)
New features
asc xcode buildprovides a first-class command for building an Xcode project or workspace.- Xcode export and publish expose signing style, team, and related export options.
- Workflows accept bounded per-step retry and timeout settings and terminate timed-out process trees.
- Workflow validation accepts explicit JSON output from a validation step.
- TestFlight publish supports upload-only mode for pipelines that distribute or add notes later.
- TestFlight can list beta groups containing a selected build.
- Release staging reconciles routing coverage and includes verified coverage upload stages.
Improvements and fixes
Build, publishing, and signing
- Next-build-number selection uses the highest usable processed build number across paginated history and in-flight uploads.
- Restricted accounts retain next-number safety checks, while unusable processed numbers are skipped with a warning.
- Publish retries post-upload TestFlight propagation and correlates TestFlight reviews with their builds.
- Synchronized signing assets stay profile-scoped, and unusable profile certificates are skipped.
- Signing fetch preflights every output path and signing repository Git operations run non-interactively.
- Auth normalizes key and issuer identifiers before token signing.
- macOS local profile commands resolve the active Xcode provisioning-profile directory and fall back when Xcode cannot be queried.
- Unified certificates are recognized for Mac signing.
- User role and visible-app updates are sent together.
Assets, screenshots, previews, and notarization
- Interrupted screenshot uploads reconcile reservations before retrying and use canonical reviewed upload targets.
- Screenshot planning fixes iPad slot selection.
- App Preview files are validated before upload.
- Video-preview detail lookup errors are preserved.
- Notarization preserves archive identity and reports failed multipart completions.
- Xcode failures preserve early diagnostics and honor reported validation failures.
- Shared output writes publish new files only after successful writes, and Xcode Cloud artifact writes are atomic.
Validation, pagination, and diagnostics
- Accessibility and category commands reject conflicting pagination options, while webhooks resume from continuation URLs.
- Analytics, assets, builds, ratings, and TestFlight requests renew deadlines during long operations.
- Localization plans, migration payloads, App Clip selectors, version includes, app setup, Slack blocks, and Xcode combinations are checked before side effects.
- App-info version resolution traverses all pages.
- Certificate request output paths are preflighted, and pass-type queries require certificate includes before certificate fields or limits.
- HTTP conflicts and 422 failures use the intended exit classifications.
- Analytics accepts valid instance and segment resource IDs, and Game Center metrics return authentication errors.
- Matchmaking weights reject NaN and infinity.
- Copyright validation warns when text does not start with the four-digit acquisition year.
- Win-back
FREE_TRIALcreation uses--territory, omits a subscription price point, and rejects an incompatible price. - Background-asset file updates require
--checksum, pricing tier cache writes are atomic, and generated app names preserve Unicode. - Structured output write failures propagate, and Slack validation rejects null block payloads.
Breaking changes and migration from 3.7
- Read the checked Migrate to 4.0 guide and run
asc --helpplus relevant command help against the 4.0 binary. asc review items view ...andasc review items-get ...were removed; useasc review items list --submission "SUBMISSION_ID".- Replace analytics
--statewith--access-type, replace analytics--datewith--processing-date, and replace Review item--statewith--resolvedor--removed. - The singular
appStoreVersionExperimentV2item-type alias was removed; useappStoreVersionExperimentsV2. screenshots upload --replaceandvideo-previews upload --replacerequire--confirm;--replace --dry-runremains available without it.- 4.x temporarily accepts signing
--devicewithout--create-missing, but warns and ignores those IDs; 5.0 rejects that combination. - Signing fetch and signing sync push refuse existing output files, so clean output directories before rerunning them.
- Previously accepted ignored flags now fail before authentication or API requests, including conflicting pagination, invalid Xcode values, missing includes, and delete-bearing metadata without
--allow-deletes. - Fastlane import honors Deliverfile
metadata_pathandscreenshots_path, resolves them relative to the Deliverfile, and requires--allow-external-metadataor--allow-external-screenshotsfor external paths. - Fastlane recognizes
platform "osx"andplatform "xros", screenshot uploads use the upload timeout, and invalid locale directories fail before confirmed import. - Build numbers use the highest positive processed or in-flight value; local profiles follow active Xcode;
asc release stageaddsvalidate_buildatsteps[0]. - Workflow numeric outputs retain JSON numbers, while partial migration output reports
status: "partial"with a non-zero exit. - Screenshot classification covers Apple Watch, Mac, and 13-inch iPad; retired
APP_IPAD_PRO_129is no longer created by planning or applying. - Ambiguous 3840x2160 screenshots need an Apple TV or Vision Pro filename hint.
asc profiles local clean --confirmoperates in the active-Xcode-resolved directory; inspect it or pass--install-dirbefore destructive use.
Audit, tests, CI, and community
- The 4.0 audit corrected Review, release staging, workflow output, help, migration, and TTY-aware signing behavior.
- Review regression coverage and web-only doctor coverage were expanded or disclosed where the command could not verify a state.
- WinGet release CI avoids requesting workflow scope.
- Atomic output, notifier validation, request deadlines, certificate paths, app setup, pricing, webhooks, and user-access safety received fixes.
3.7.0 (2026-08-09)
New features
- The new
asc web bundle-ids capabilities enableworkflow authenticates against the Developer Portal, checks that the capability is available and editable for the account, performs an exact Bundle ID update, and returns enabled/changed/status output.
Improvements and fixes
- Azivault joins the Wall of Apps.
3.6.1 (2026-08-08)
Improvements and fixes
- macOS release artifacts now receive Developer ID signature and notarization verification.
- Interrupted release workflow steps can be retried with guarded publication and recovery behavior.
3.6.0 (2026-08-08)
New features
- The Asset Library capability has a discoverable command skeleton while the API surface is being exposed.
API and resource compatibility
- Video-preview validation accepts Apple’s iPhone 6.9 device alias, and app-event and nomination validation match the current contracts.
- Xcode Cloud and OpenAPI response decoding preserves typed and currently returned fields instead of silently dropping them.
- App Store version validation, Bundle ID capability settings, pass-type pagination, and user-role validation now follow Apple’s contracts.
- Version-localized search keywords are updated through the correct resource.
- Introductory-offer reads, promotional-offer inline prices, and review/pre-order requests use the corrected response and request shapes.
- Signing requests use BundleIdPlatform, and unsupported TestFlight external-state editing is deprecated.
- App Clip advanced experiences, webhooks, and Game Center v2 requests and output now match Apple’s contracts.
- Analytics and sales-report API contracts are corrected; App Clip inline-localization failures now return the correct exit status.
- Capability matching recognizes all supported Asset Library spellings.
Reliability and maintenance
- PTY-dependent web-auth tests are isolated, TestFlight feedback fields remain available when screenshots are included, and build-upload timeout coverage is stable.
- Crypto, text, and Bitrise utility dependencies are updated.
- Spottable: Marketplace Alerts joins the Wall of Apps.
3.5.1 (2026-08-05)
New features
- The new
asc web api-keys createworkflow creates an all-apps team key, downloads and verifies the one-time P8, saves the key and issuer metadata, and reports partial outcomes when a later step fails.
Improvements and fixes
- Pricing availability bootstrap now fails closed when Apple rejects it, and permanently rejected telemetry events are dropped instead of retried forever.
Maintenance
- EQMonitor, Storyie – AI Journal & Diary, Pool, and Minimal Minesweeper join the Wall of Apps.
3.5.0 (2026-08-03)
New features
- Certificate workflows support pass-type ID certificates, and analytics queries can filter view instances server-side.
Improvements and fixes
- IPA uploads now validate app identity before starting, ambiguous upload-finalization responses are reconciled, and inherited Xcode output waits are bounded.
- Xcode build-settings fallback is explicit, and gosec failures reach the security check’s exit status.
- A non-publishing release rehearsal validates artifact and workflow behavior.
- Vulnerable dependencies are updated, Dependabot is enabled, and CI uses centralized Go toolchain versions.
Maintenance
- 织诗 – AI写诗与古诗词创作 and Doco Translate: PDF Translator join the Wall of Apps.
3.4.1 (2026-08-01)
Improvements and fixes
- Analytics decoding and validation accept the current sales-report versions returned by App Store Connect.
3.4.0 (2026-08-01)
New features
- Web auth can store Apple Account passwords in the native credential store keyed by Apple ID, report whether one exists, remove one, or clear all; storage is bypassed when keychain access is disabled.
Maintenance
- Home Cameras, The Pot – Stake your claim, Ninou: baby tracker, and Flash – appareil photo jetable join the Wall of Apps.
July 2026
3.3.0 (2026-07-30)
Improvements and fixes
- IPA Info.plist expansion and review-response batch fan-out are bounded to limit untrusted workload size.
- Credentials are redacted at output and error boundaries, and helper environments are isolated.
- Repository-controlled file I/O is rooted and rejects path traversal and symlink escapes.
- Workflow examples, interpreted output, and install-skills dependencies are hardened.
- Post-merge release blockers and regression gaps are closed.
Breaking changes
- File-driven batch mutations now require explicit
--confirm, and privileged mutations bind to their exact captured target. Scripts that previously supplied a file and mutated immediately must add--confirmand should review the target-binding behavior.
3.2.0 (2026-07-29)
New features
- The
asc app-clips default-experiences createworkflow accepts--template-idand asks Apple to copy the template experience’s header image and localizations onto the new experience.
Improvements and fixes
- Apple Ads campaign updates require a campaign envelope, for example
{"campaign":{"status":"PAUSED"}}.
Maintenance
- SharePal – Quick info sharing! joins the Wall of Apps.
3.1.3 (2026-07-28)
New features
- Screenshot validation detects duplicate pixels and reports the conflicting files before upload.
Maintenance
- SilkScreen Mesh Gradient, Speed Reading – WPM Arena, and Cardstock: Sports Card Scanner join the Wall of Apps.
3.1.2 (2026-07-26)
New features
- In-app purchase workflows support free offer codes.
Improvements and fixes
- Search results prioritize canonical workflows, and free offer-code prices render correctly rather than appearing missing or non-zero.
Maintenance
- FreeDive Ultra, kardfolio: Card Benefits, cubby: stash & track, Vintsnap: AI Listing Photos, and Emma’s Library join the Wall of Apps.
3.1.1 (2026-07-20)
Improvements and fixes
- API debug output exposes rate-limit fields to make throttling easier to diagnose.
Maintenance
- Chronoid and SmoothCapture join the Wall of Apps.
3.1.0 (2026-07-17)
New features
- Version-scoped API 4.4.1 resources cover in-app-purchase versions, subscription metadata and group versions, and review items.
- API 4.4.1 age-rating, pricing, and sparse app fields are exposed.
- Schema output exposes request relationships, making the required linkage shape inspectable before a request is sent.
- Structured Xcode project version editing and export-options generation from an archive carry project and archive metadata into build/export workflows.
Improvements and fixes
- The OpenAPI snapshot, coverage plan, and command documentation are synchronized with API 4.4.1.
- Invalid age-rating combinations, adjusted-equalization requests, and other API 4.4.1 inputs are rejected before mutation.
- Relationship-limit flags use the corrected plural form, and legacy API 4.4.1 resource spellings are deprecated in favor of version-scoped resources.
- Deprecated in-app-purchase submit discovery is restored, and subscription localization deletion has explicit confirmation coverage.
- Nullable request fields and related sparse fields are preserved for versioned in-app-purchase and subscription resources.
- Absolute xcconfig groups resolve correctly when editing Xcode projects.
3.0.0 (2026-07-16)
New features
- Pricing workflows can create missing app-availability records.
- Canonical view and edit command forms are defined for consistent command discovery.
Improvements and fixes
- Focused invocations build only the selected command tree, and output-renderer registration is deferred until first lookup.
- Uploads use four default chunk workers and a tuned transport.
- Complete environment credentials skip keychain lookup, and failed pagination or key-file writes are guarded and cleaned up.
- Unknown flags and help text are clearer, and analytics-ranked flag aliases are accepted.
- Web HTTP status is preserved in exit codes for ordinary, retried, and authentication failures.
- Invalid private keys are usage errors and invalid web credentials are authentication errors.
- Missing app availability and missing availability edits are classified as not-found outcomes.
- Metadata, subscription-setup, subscription-screenshot, and authentication validation findings are classified in telemetry.
- Subscription-availability remediation points to the correct repair path.
- Installation checksum verification fails closed and release binaries are stripped.
2.8.2 (2026-07-13)
Improvements and fixes
asc subscriptions validatechecks UPFRONT and MONTHLY commitment plan availability and reports actionable territory and pricing remediation, including review-screenshot delivery state.- Subscription pricing now materializes the complete price matrix so paginated or sparse price-point data does not produce an incomplete result.
- Verified Wall of Apps automation merges are documented for maintainers.
Maintenance
- YouInMeme: Face Swap Memes joins the Wall of Apps.
2.8.1 (2026-07-11)
Improvements and fixes
- Compliance-form requests now send the
X-Csrf-Itcheader required by the web endpoint.
2.8.0 (2026-07-11)
Improvements and fixes
- macOS release binaries are signature-verified after signing.
- Repeated local builds avoid unnecessary tooling work and complete faster.
- Metadata keyword workflows are split into command-owned files, Xcode Cloud operations into resource files, and submission and screenshot workflows into focused files.
- ASC client queries are grouped by resource to make endpoint behavior easier to maintain.
- CI runs checks on native runners and selects checks from the changed scope.
- Obsolete low-signal coverage is removed and the 2.8.0 release readiness checks are hardened.
Breaking changes
- The ASC Studio application, its frontend, and its dedicated release/check workflows were removed. Users of that separate application must continue with the
ascCLI workflows.
2.7.0 (2026-07-10)
Improvements and fixes
- Xcode Cloud workflow responses retain typed fields returned by Apple.
- Skills availability checks run off the command path, so normal invocations do not pay that check’s latency.
- Telemetry is stored and forwarded asynchronously, with bounded v4 outcomes and collector latency tolerated in production.
- Readiness validation collapses independent checks and runs them in parallel.
Maintenance
- Envelope Budget – Kualia joined the Wall of Apps.
- The MewMax AI Wall of Apps entry was removed after its earlier addition.
2.6.1 (2026-07-08)
New features
asc metadata planwrites a review artifact from canonical metadata;asc metadata approveapproves all, selected keys, or scopes; andasc metadata statusreports the local approval state. The apply path verifies the approved plan before writing.
Improvements and fixes
- Failure telemetry now emits sanitized failure parameters.
- The Go toolchain is updated to 1.26.5.
Maintenance
- Swooni: Relationship Tracker, Capture GO – AI & Online, and Velko: IPTV Player & TV Guide join the Wall of Apps.
2.6.0 (2026-07-06)
New features
asc web apps delete --app APP_ID_OR_BUNDLE_ID --confirmresolves the selected app, verifies the target, and deletes it through Apple’s web API.asc web removed-apps listlists apps visible in the Removed Apps status view.
2.5.1 (2026-07-05)
Improvements and fixes
- Web-session workflows that had completed their stability period are promoted into the supported command surface.
- Integration key files use restricted permissions.
- The scheduled weekly integration test job is removed.
Maintenance
- Nemlys: Couple & Relationship and LookForward: Movies & Games join the Wall of Apps.
June 2026
2.5.0 (2026-06-28)
New features
asc review itemsnow provides nestedlist,get,add,update, andremovecommands for review-submission items.asc subscriptions list --app APP_IDresolves an app scope across its subscription groups.
Improvements and fixes
- Subscription setup reuses matching groups, subscriptions, localizations, prices, and availability records, verifies the resulting state, and reports a clear conflict when an existing resource does not match the requested configuration.
- Subscription price set converges on an existing matching price instead of creating a duplicate.
- Subscription localization create and IAP localization create are idempotent when the requested localization already exists.
- Build-test-note localization creation reuses an existing matching localization.
- Validation failures are classified in telemetry, and review-rating lookups resolve the app identifier before requesting ratings.
- App-info edit converges after localization conflicts instead of leaving an ambiguous partial result.
2.4.1 (2026-06-28)
Improvements and fixes
- Resolved price listing now selects the newest matching relationship record and preserves the associated territory and plan type.
- CI runs independent GitHub Actions steps in parallel and shards Go tests across runners.
Maintenance
- Rote.ink and AnLi Kids join the Wall of Apps.
2.4.0 (2026-06-26)
Improvements and fixes
- Anonymous telemetry events now carry bounded command, invocation, error-kind, and failure-stage context, while keeping the event payload sanitized.
- Maintainer workflows are migrated into the repository’s agent-skill packages, making audit, release, issue, Wall of Apps, and related procedures discoverable and reusable.
2.3.0 (2026-06-24)
New features
- Failed screenshot uploads write a failure artifact that can be resumed with
asc screenshots upload --resume PATH; resume continues pending files and ordering work without recreating completed uploads. - High-level workflow runs can resume from a saved run ID with
asc workflow run --file FILE release --resume RUN_ID, reporting resumed step state. - TestFlight crash and feedback list commands accept
--includeto request related resources from Apple.
Improvements and fixes
- Introductory-offer operations now enforce their timeout contract instead of waiting without a bounded deadline.
- Webhook shutdown no longer races on its shutdown channel.
- App-info batch test counters are race-safe.
- Missing subscription App Review screenshots are reported explicitly so validation can name the required upload.
Maintenance
- Mafy – Dog Care Tracker and Accountable AI – Habit Blocker join the Wall of Apps.
2.2.0 (2026-06-20)
New features
- The new
asc storekit retention-messagingcommand group covers image and message list/upload/delete operations, default-message view/set/delete, endpoint view/set/delete, and performance start/view/wait operations. - StoreKit retention messaging requests support the sandbox and production environments, validate UUIDs and message payloads, and use the retention-messaging API’s image, message, default, and performance resources.
2.1.2 (2026-06-19)
Improvements and fixes
- Telemetry status, enable, disable, and reset-ID operations are documented alongside ASC_TELEMETRY_DISABLED, ASC_TELEMETRY_ENDPOINT, and ASC_TELEMETRY_EPHEMERAL.
- The README and generated command documentation disclose anonymous telemetry.
Maintenance
- Quotify, Tessera, Matchday, Cairn, Vigil, and Hush for visionOS join the Wall of Apps.
2.1.1 (2026-06-18)
New features
asc telemetry status,asc telemetry enable,asc telemetry disable, andasc telemetry reset-idlet operators inspect and control anonymous CLI telemetry.
Improvements and fixes
- Adds an iOS release guide for agents covering the build, signing, upload, and App Store Connect handoff.
Maintenance
- Tiny Decisions joins the Wall of Apps.
2.1.0 (2026-06-16)
New features
asc subscriptions pricing monthly-commitmentsupports listing, enabling, disabling, and bootstrapping paired UPFRONT and MONTHLY prices for supported territories.- Monthly-commitment list and price list commands accept
--plan-type, and enable can create MONTHLY prices. asc builds next-build-numbernow resolves the next safe number from both the latest processed build and the latest in-flight upload, avoiding reuse after a zero-build upload.
Improvements and fixes
- The OpenAPI snapshot is synchronized with Apple’s API 4.4 republish, and monthly-commitment and STORAGE metric documentation is updated.
- The CLI warns when the deprecated ACCESS_TO_REPORTS user role is used.
- Alternative-distribution help includes EU addendum guidance.
- FREE_TRIAL offer-code prices are resolved with the correct territory price relationship.
Maintenance
- Game Box, PicVore, Midnight, Peptide Protocol, WatchRadar, and Unseen Accessibility joined the Wall of Apps.
- The monthly-commitment plan-type filter is documented.
2.0.0 (2026-06-10)
New features
asc xcode inject --manifest FILEgenerates plist, JSON, text, and copied-asset outputs from a deployment manifest.--set key=valueoverrides manifest values,--dry-runvalidates without writing, and--overwritepermits replacing existing outputs.- Individual App Store Connect API keys are supported in configuration and JWT signing. Individual credentials use the
subuser subject and do not require an issuer ID. - Subscription plan availability, app-availability content statuses, and API 4.4 schema/index coverage are added.
- Background-asset list commands can filter by locale, and performance metrics recognize STORAGE.
Improvements and fixes
- Win-back offer creation inlines price relationships and validates or clarifies price-point inputs before sending the request.
asc install-skillsapplies a timeout and installs skills globally as intended.- API notes record the monthly-commitment behavior and the ACCESS_TO_REPORTS role deprecation.
- The Makefile adds a parallel test target for multi-core local execution.
Breaking changes
- Deprecated command implementations are removed from the current command tree.
- The beta
build-localizationsgroup and legacyasc builds findandasc builds latestpaths are gone; useasc builds infoandasc build-localizationsas shown by help.
Maintenance
- CabinLink, VVTerm, Leafty, VivyShot, and Numby Pro join the Wall of Apps; CabinLink also receives an icon update.
1.9.2 (2026-06-06)
New features
- Keychain credentials can now move to
config.jsonwithasc auth export-to-config --confirm; the command exports embedded private-key material to a restricted.p8file when the original path is unavailable, preserves the selected default profile, and reports per-profile warnings when cleanup cannot finish.
Improvements and fixes
- The Go toolchain and module dependencies are updated.
- The Wall of Apps adds Cruisea: Real-time Tracking, Alune: Planner & Assistant, App Time Limit: Screen Leech, journeybot: trip packing list, Cinefuse: AI Movie Maker, and Spritz.
1.9.1 (2026-06-02)
Improvements and fixes
asc profiles listnow includesACTIVEandINVALIDprofiles by default and accepts--profile-statefor narrower results; pagination keeps the filter on subsequent pages.
1.9.0 (2026-06-01)
New features
asc adsnow covers Apple Ads Campaign Management API v5 resources, including campaigns, ad groups, ads, keywords, negative keywords, targeting, reports, and account context. It uses separate Apple Ads OAuth credentials and supports named profiles orASC_ADS_*environment variables.- Apple Ads operators get setup, org-discovery, read-only smoke-test, reporting, raw-request, and guarded-cleanup playbooks.
- Campaigns can be paused or resumed with
asc ads campaigns pause --campaign ID --org ORG_ID --confirmand the matchingresumecommand. - Report presets cover campaign, ad-group, keyword, search-term, ad, and nested ad-group levels. They build requests from flags such as
--from,--to,--last-days,--granularity,--fields,--sort,--limit, and--time-zone; custom selectors remain available through JSON payloads. - Endpoint and auth behavior has regression coverage, including the no-org
meandaclspaths. Report presets validate selectors, integer IDs, UTC rolling ranges, ORTZ rules, required ordering, and report-level restrictions.
Improvements and fixes
- Ads authentication now supports discovery, profile validation, doctor diagnostics, and direct short-lived token output behind
--confirm, with clearer separation between Ads and App Store Connect credentials.
May 2026
1.8.0 (2026-05-31)
Improvements and fixes
- Screenshot fan-out rejects duplicate names before upload, preserving unambiguous local artifacts and relationship updates. Downloaded screenshots retain their server order, and resumable or skipped uploads synchronize relationship order for locales with no new files.
- Build lists can exclude expired builds, and latest-build selectors expose
--exclude-expiredwith its--not-expiredalias; these selector flags require--latestwhere the selector is ambiguous. - Release and submission selection accepts
READY_FOR_DISTRIBUTION, allowing a processed version to continue through the expected flow. - Web authentication can select a provider and carry it through cached and prompted sessions; phone-based two-factor behavior has regression coverage.
- The web session can sync an App Clip's parent-bundle capability with app-scoped lookup, update, validation, and output.
- Device registration reuses an already registered UDID instead of treating an idempotent Apple response as a hard failure. Long bundle-identifier filters split into API-safe requests while retaining the complete result set.
- Review demo password length is checked before a web-session request, and certificate tests cover Unicode CSR subjects. Internal TestFlight group payloads also receive regression coverage.
- The Wall of Apps adds Vaultaire: Photo Vault.
1.7.0 (2026-05-30)
New features
- Release automation now generates WinGet manifests, uploads them as release artifacts, and submits the
Rorkai.ASCpackage manifest tomicrosoft/winget-pkgs. asc screenshots uploadenforces the App Store screenshot-set cap and lets operators select the first N sorted files with--max-screenshots;asc xcode export --timeout DURATIONbounds the localxcodebuild -exportArchiveprocess and reports a timeout with command context.
Improvements and fixes
- The release follow-up fixes retry handling when WinGet publication has to be repeated.
1.6.1 (2026-05-29)
New features
- Web sessions now expose App Store compatibility opt-ins through
asc web apps compatibility view --app APP_IDandasc web apps compatibility edit --app APP_ID --ios-app-on-mac=BOOL --ios-app-on-vision-pro=BOOL; the update targets the selected settings.
Improvements and fixes
asc signing fetchnow scopes profile retrieval to the resolved bundle ID resource, preventing a matching profile from another bundle from being selected.- The maintainer workflow now documents how release announcements are recorded, and helper scripts ignore generated Python bytecode.
1.6.0 (2026-05-28)
New features
asc profiles inspect --path ./profile.mobileprovisionparses a local provisioning profile without an App Store Connect request and supports JSON, table, markdown, and optional--entitlementsoutput.
Improvements and fixes
- The Iris attach flow skips its POST when an IAP already reports an operation in flight, reducing duplicate web-session writes during retries.
- Wall of Apps fork submissions now validate that the parent entry exists and belongs to the requested fork.
- Localization update diagnostics preserve attempted field context when Apple's error response is generic.
- The hand-maintained website changelog and release-doc validation were removed in favor of GitHub-generated release notes.
- The Wall of Apps adds RecipeBee: Recipes & Meal Plan and Watchletic - Run tracker.
1.5.4 (2026-05-26)
Improvements and fixes
- Iris IAP listing fields are corrected, and
--iap-idaccepts either the Iris resource ID or the bundle-styleproductId; the command resolves the input to the Iris ID before posting and narrows already-attached handling to true idempotent conflicts.
1.5.3 (2026-05-26)
New features
asc web review iaps attachnow handles non-renewing in-app purchases with app-scoped lookup, a review-submission target, confirmation for the write, idempotent already-attached handling, and resolved-resource output.
Improvements and fixes
- The README now shows macOS TestFlight distribution end to end, including
.pkgupload and adding the build to a macOS tester group. - The Wall of Apps adds PodSized: AI Podcast Summaries.
1.5.2 (2026-05-25)
New features
asc status --platformcan scope universal-app dashboards to iOS, macOS, tvOS, or visionOS when resolving builds, App Store versions, and review submissions.- Certificate creation can generate the CSR inline from supplied subject values and continue through the signing flow.
Improvements and fixes
- Offer-code commands now print follow-up hints for the next list, value-export, or status command.
- The Wall of Apps adds UrbanAir: Unlock all escooters.
1.5.1 (2026-05-22)
New features
- Equalized subscription pricing can be scheduled with an explicit or derived start date;
--dry-runpreviews the plan, the result reports schedule state, and invalid boolean values fail before an update.
Improvements and fixes
- Subscription offer-code list and value exports now sanitize names, keep table and markdown columns consistent, report CSV write failures, and cover one-time-code values.
- The Wall of Apps adds Sam Webpage Summarizer, AcheNote - Symptom & Visit Log, Allergy Translate, Parrot - AI Personas, Hedwig - Block Text Messages, Squeaker - Dog Training Sounds, Embers to Dyson, Metrociego, ReaderFlow | Read Later, FeedFlow - RSS Feed Reader, Kavale - Sécurité Équestre, and FishLogger.
1.5.0 (2026-05-18)
New features
asc searchbuilds a deterministic local index over command paths, summaries, usage text, examples, and flag names. It supports command-oriented aliases, typo-tolerant fallback matching,--limit, and JSON, table, or markdown output.asc reviews respond-batchgroups customer review replies, supports--dry-run, skips reviews that already have a response, and filters by response state before writing. Review lookup exposes responded and unresponded filters plus the response fields needed to plan batches.
1.4.2 (2026-05-16)
New features
asc background-assets submitplans the selected version, supports--dry-run, reuses an existing review submission when possible, and rolls back an attachment if submission fails.
Improvements and fixes
asc apps wall submit --countrycan resolve a non-US storefront such as Japan. Metadata validation preserves blank-template behavior while tightening app-info and version-localization checks.- The Wall of Apps adds Fablum: EPUB & PDF Reader, PronoGP, and Steplee – Love. Walk. Win..
1.4.1 (2026-05-11)
New features
asc metadata initcreates locale-aware app-info and version-localization templates with validation-friendly defaults.- An experimental, guarded monthly-with-12-month-commitment subscription surface covers Apple's April 2026 announcement. It validates
ONE_YEARsubscriptions, excludes the USA and Singapore territories, and enforces the 1.5x upfront-price rule while the public App Store Connect API lacks billing-mode fields.
Improvements and fixes
- Xcode Cloud secret environment-variable creation now fetches its encryption key from the CI auth endpoint outside the
/ci/apibase path. The metadata docs explain when version-localization IDs become available toasc metadata validate. - The Wall of Apps adds Fitnit: Health & Fitness, Spotter - The Travel Companion, and Greenie: Plant Identifier AI.
1.4.0 (2026-05-08)
New features
asc capabilitiesreports coverage for CLI, public-API, web-only, and API-limited workflows, with JSON, table, and markdown output plus--statusand--areafilters.asc publish appstore --metadata-dirvalidates and plans a prepared metadata directory, applies version metadata, then continues through App Store submission.- Subscription review notes can be updated, and an experimental web-session command removes a subscription from sale with confirmation and post-write verification.
Improvements and fixes
FREE_TRIALsubscription offer-code creation no longer requires--pricesand rejects price input that does not apply to that mode.- Analytics report relationship lookup accepts Apple-prefixed report IDs, and metadata workflows recognize the current Bangla locale alias,
bn-BD. - Repository formatting and Go tooling are refreshed, and
govulncheckruns with a patched Go toolchain. - The Wall of Apps adds Kilowatt – Electric Car Timer, Floating Head, show yourself, Pocket Mole Watch, Master Indicator, Margin: AI Article Reader, Sift - AI Food Scanner, ZenJournal:Stress-free Journal, MealMate: Calorie Counter, and DayCount: Countdown Widget.
1.3.0 (2026-05-04)
New features
asc analytics request --reuse-existingreturns an active matching request before creating another one and falls back to that request on an App Store Connect duplicate-request conflict.asc apps registry pullmaintains.asc/app-registry.jsonby refreshing App Store Connect identity data, preserving local-only fields, supporting dry-run planning, rejecting duplicate keys, writing through symlink-safe paths, and requiring--confirmwith--prune-missing.
Improvements and fixes
- The release includes documentation and command-level regression coverage for reusable analytics requests and app-registry pulls.
1.2.8 (2026-05-03)
Improvements and fixes
- The Wall of Apps adds Pillcase - Medication Reminder, Dot. Extend Your Digital World, Pal Chat - AI Chat Client, Pal Cal - AI Calorie Counting, and Checkify: #1 AI Bill Splitter.
- The Wall of Apps also adds Custom AI Charades, PixShrink - HEIF Conv., Slop Or Not - AI Fake Detector, Clean Links: URL Privacy, Fasting Works: IF & Meal Log, and Harvest - One-Tap Summary.
April 2026
1.2.7 (2026-04-27)
New features
asc subscriptions offers introductory createaccepts--all-territoriesand--territory ALL; it reads current availability, supports--dry-run, skips existing introductory offers, reports created/skipped/failed counts, and rejects a price-point override that cannot be applied consistently across territories.
Improvements and fixes
- The macOS CI regression check for web-auth Ctrl+C is stable while retaining assertions for a non-usage exit and no password-required fallback.
- The Wall of Apps adds BratVPN.
1.2.6 (2026-04-24)
Improvements and fixes
asc subscriptions setupauto-enables--price-territorywhen--territoriesis omitted, while preserving territory overrides,preserveCurrentPrice, and start-date fields in the pricing request.- The Wall of Apps adds Echo Sleep: AI Sleep Sounds.
1.2.5 (2026-04-23)
Improvements and fixes
- Workflow validation permits duplicate output-producing step names in independent workflows, still rejects a collision when both producers can run in the same graph, avoids partial reachability-cache results across cycles, and documents output scope.
- The Wall of Apps adds This Day: Photo Cleaner and Model Usage.
1.2.4 (2026-04-22)
New features
asc publish testflight --submit --confirmcan submit external groups for beta review, reusing thebuilds add-groupssubmission helper, waiting for a processing build where required, and reporting beta review state in publish output.
Improvements and fixes
- The README shows a complete single-locale screenshot upload, and the docs clarify the app-info localization variant and refresh related workflow examples.
- The Wall of Apps adds Focus Rail: Pomodoro Timer, Kosaku - Beautify the content, and FlightCatcherPro – Plane Spot.
1.2.3 (2026-04-17)
Improvements and fixes
- Repository, documentation, and issue links now use
rorkai. Homebrew releases publish to therorkaitap, with a formula smoke test matched to the current help surface. - The web-auth interrupt PTY test is more stable, and the legacy installs-badge workflow is removed.
- Release automation refreshed the estimated-downloads badge.
- The root CLI tagline and branding are refreshed, and the Wall of Apps adds Yabaleli, Set - Strength Log, Wat Kham, ThaiQuest, Klick #1 AI Camera Assistant, MiniHue: Color Mini Sudoku 6x6, and Akari Glow: Light Up Puzzles.
1.2.2 (2026-04-14)
New features
asc app-clips invocations createaccepts--localeand--title, validates the pair, and creates the required localization inline with the invocation.
Improvements and fixes
- Fastlane
Deliverfileimports withskip_screenshotshave regression coverage; submission lookup not-found and empty version-ID branches are also covered. - Release automation refreshed the estimated-downloads badge.
- The Wall of Apps adds Newgrain: Film Photo Community, AI Chat Assistant - Chappie, Shluffy - A Baby Sleep Coach, Dateminder - Event Reminders, and Splitie – Split & Settle Bills.
1.2.1 (2026-04-11)
Improvements and fixes
asc migrate importskips unsupported screenshot files such as.DS_Store, tolerates empty locale directories, resolves metadata-only layouts without ascreenshots/directory, and exposes--skip-screenshotsfor an explicit metadata-only run. Submission regression coverage includes build attachment and existing-submission lookup.- Release automation refreshed the estimated-downloads badge.
- The Wall of Apps adds Terraforge: Alchemy Craft Game, SiteCalc: Trades Calculator, and Moda: Driving Permit Hours Log.
1.2.0 (2026-04-09)
New features
asc review submitis the canonical shortcut for attaching a build and sending a prepared App Store version through the modern review-submission flow; it reuses shared preflight and submission logic and emits caller-specific remediation.
Improvements and fixes
- The shared review path now short-circuits an already submitted version before preflight or build attachment, and
asc publish appstore --submitreturns cleanly on a submitted version. Regression tests cover submitted-version reruns, price-territory parsing, and screenshot resume-mode conflicts. - The release fixes the auth-doctor migration guidance order for the review-submit flow and checks screenshot resume-mode conflicts and subscription price-territory parsing.
- Release automation refreshed the estimated-downloads badge during this release.
- The Wall of Apps adds Voice Reminder Planner: Echo, Shua - arXiv Paper Reader, Nitra, Time Blocking Planner: Align, and SquishPic: Image Compressor.
1.1.1 (2026-04-06)
Improvements and fixes
- Keyword-limit validation now counts characters rather than UTF-8 bytes across shared metadata and localization flows, fixing incorrect rejection of Arabic, Japanese, and other multibyte scripts.
- Focused screenshot-set upload regression coverage catches failures in the shared asset-upload helper.
- The Wall of Apps adds Imposter Game: Fakeout Party, QontactR, RateTier, and SweatCount - Workout Calendar.
1.1.0 (2026-04-06)
New features
- Screenshot upload can fan out one prepared set across selected localizations, resume from upload artifacts, retry failed work, and validate before a large run.
- Metadata has a keyword-audit command and direct keyword push, with partial failures reported per locale.
- Localization workflows discover supported locales, apply them in bulk, document locale forms, and warn when a new localization is incomplete for submission.
asc validateincludes remediation guidance by default, whileasc publish appstorecan produce a dry-run plan without requiring the full auth preflight.
Improvements and fixes
- Equalizations pagination now matches other collection commands and territory updates retry after rate limiting. Territory names containing commas parse correctly in CSV input.
- Review status explains stale removed submissions and standardizes the not-configured state; new app events default to unscheduled. Auth-status help is easier to discover.
- Localization keyword validation added byte-aware limits for the release's metadata path; the following 1.1.1 patch corrected this to character counting. Release automation also refreshed the estimated-downloads badge.
- The Wall of Apps adds Forerunner: Running & Wellness, the apps from the contributor batch, Printer Tools App, Scooter Tools, AdMate App, Haven: Setup Codes, and EchoKeep: Smarter RSS Reader.
1.0.1 (2026-04-04)
Improvements and fixes
- Generic App Store Connect write failures now include attempted metadata field names, and localization diagnostics retain whitespace-only field context. Failed-delivery verification for IAP and subscription-group review screenshot creation has regression coverage.
- The estimated-downloads badge is refreshed by the release automation.
- The installs badge is refreshed, and the Wall of Apps adds DeskTally and HoverCalc.
1.0.0 (2026-04-03)
Improvements and fixes
- Deprecated commands, aliases, and compatibility wrappers are removed; canonical
viewandeditsurfaces are standardized; and runtime migration messages point publishing, release, submit, age-rating, and build workflows to their replacements. - The release adds the dedicated Migrate to 1.0 guide and refreshes command pages and command-surface tests to match the new taxonomy.
Breaking changes
- Deprecated command paths and aliases are no longer accepted. Follow the replacement shown by the 1.0 migration guide before upgrading automation; command names in this entry reflect the 1.0 release.
0.49.1 (2026-04-02)
New features
- Adds the
app-tagscommand reference to the documentation. - Refreshes the documentation for screenshot plan/apply workflows and adds the release workflow pages.
Improvements and fixes
- Fixes ASC Studio app-selection races so a stale asynchronous result cannot replace the user's current app selection.
- Adds regression coverage for stale device-sheet completion and keeps the Mintlify documentation build green.
- Adds Tintz, Blimber, Daily Self Care, Telescopo, and iCardSort to the Wall of Apps.
Breaking changes
- Renames the project to App Store Connect CLI and the desktop app to ASC Studio; the executable remains
asc.
0.49.0 (2026-04-01)
New features
- Adds ASC Studio, an agentic desktop app backed by the CLI.
- ASC Studio covers app selection, metadata, pricing, screenshots, reviews, TestFlight, finance, and command tools; its 0.0.1 packaging workflow is prepared.
- Adds local-build publishing through the App Store Connect API for prepared IPA or PKG artifacts.
- Splits additive review metadata and screenshot commands into focused operations.
- Adds stable subscription and IAP selectors based on product and reference values instead of list order.
Improvements and fixes
- Consolidates App Store publishing guidance around one canonical flow and refreshes the setup guidance.
- Adds regression coverage for IAP setup's localization context refresh between workflow steps.
- Adds six community apps to the Wall of Apps.
March 2026
0.48.1 (2026-03-31)
New features
- Adds commands to upload and synchronize PPO treatment screenshots and their localizations.
Improvements and fixes
- Corrects Windows auth-key permission checks so valid key files are accepted without weakening the protection against overly broad permissions.
- Adds regression coverage for human-readable version/platform display mapping.
- Adds Do?, Vakta, and Trip Atar to the Wall of Apps.
0.48.0 (2026-03-30)
New features
- Makes
validatethe canonical submission-readiness command for build, metadata, encryption, and review checks. - Adds
asc pricing currentand resolved current-price views for inspecting prices currently in effect. - Adds introductory-offer CSV import for repeatable territory pricing setup.
- Adds experimental web-session medical-device commands and documents experimental web surfaces for agents.
Improvements and fixes
- Displays readable platform names in table output.
- Fixes TestFlight tester group filtering and avoids a crash when Game Center list details are empty.
- Adds regression coverage for medical-device region parsing and review submission pagination/state edges.
- Adds five community apps to the Wall of Apps.
0.47.1 (2026-03-29)
New features
- Shares review-submission lifecycle and reporting across
release,publish,submit, and status workflows. - Separates help taxonomy from embedded workflows and hardens CI, hooks, and release automation.
Improvements and fixes
- Restores Mintlify source, fixes root configuration, and removes inconsistent emoji glyphs from docs builds.
- Adds regression coverage for the terminal
FAILEDbuild-wait state and test-notes selector conflicts. - Adds the Q2 incremental rewrite roadmap.
- Adds MedScan, PicSeek, SnapSong, StrictBlock, Step Counter, ExpenseKit, and Reminders at a Glance to the Wall of Apps.
- Adds Contact Sheet, MyFooderPlan, Grove, Boba Tycoon, Idle Coffee Empire, VivaDicta, and Riverside to the Wall of Apps.
0.47.0 (2026-03-27)
Improvements and fixes
- Makes
builds infothe canonical build lookup and separates latest lookup from next-number allocation. - Standardizes build and TestFlight selectors across app, version, build number, platform, and build ID.
- Adds
--group-levelsupport to subscription updates. - Restores deprecated build-selector compatibility while the canonical paths become the documented direction.
- Corrects a workflow help example and adds regression coverage for the not-expired build-info path.
- Adds four Wall of Apps entries (Zen Flip Clock, Minimal Diary, Long Distance, and Safe Period Tracker) and refreshes the downloads badge.
Breaking changes
- Migrate scripts to canonical
info,next-number, build-scoped notes, and typed selector forms. - Deprecated build spellings remain compatible in this release but are no longer preferred.
0.46.2 (2026-03-26)
New features
- Adds
--freeto app pricing so a price schedule can explicitly set an app to $0. - Adds
--all-territoriesto availability editing for applying the same availability state across every territory.
Improvements and fixes
- Verifies review-screenshot delivery after upload and reports failed or incomplete review resources.
- Refreshes the estimated-downloads badge.
0.46.1 (2026-03-25)
New features
- Adds experimental
asc web sandbox createfor authenticated creation of App Store sandbox testers.
Improvements and fixes
- Raises the default web-session rate limit to one second and strengthens the command's experimental-use disclaimer.
- Requests Apple phone 2FA codes before prompting during web authentication.
0.46.0 (2026-03-25)
New features
- Adds experimental analytics dashboard commands to the web-session surface.
Improvements and fixes
- Adds Connectarr to the Wall of Apps and refreshes the estimated-downloads badge.
0.45.4 (2026-03-24)
New features
- Adds
asc analytics comparefor comparing sales metrics across two periods. - Adds
video-previews set-poster-framefor setting the poster frame of an uploaded preview.
Improvements and fixes
- Pins Koubou 0.18.1 for reproducible screenshot framing and covers build-count validation edges.
- Adds Iconize Folder, KeyClicker, RegexMate, FocusCursor, DayBar, and wrkout to the Wall of Apps.
- Refreshes the release badge.
0.45.3 (2026-03-23)
Improvements and fixes
- Prefers
viewandeditverbs on canonical command surfaces, making help and automation vocabulary consistent. - Expands subscription metadata diagnostics for missing localization and pricing readiness gaps.
- Isolates command-test frame and cache state to reduce test interference.
- Refreshes the estimated-downloads badge in the release automation.
- Adds Super Shot, Pievra, 6 Nations, Gecko Med, Jurni, and NextCatch to the Wall of Apps.
- Refreshes the release badge.
0.45.2 (2026-03-22)
Improvements and fixes
- Hardens upload verification and submission hints when processing has not reached a usable state.
- Adds a public-app privacy readiness advisory to validation.
- Pins Koubou to 0.18.0 for stable screenshot framing.
- Adds Receipts Manager: Receipteka to the Wall of Apps.
0.45.1 (2026-03-21)
Improvements and fixes
- Adds lazy auto-reauthentication when an expired web session is encountered.
- Replaces the unreliable web 2FA input with command-based code retrieval, reducing failures in web-session login.
- Pins Koubou to 0.17.1 and preserves stable screenshot-frame slugs.
- Adds Auto Metric to the Wall of Apps.
0.45.0 (2026-03-21)
New features
- Adds experimental web-session subscription attachment workflows.
- Adds beta review submission support to
builds add-groupsfor external TestFlight groups. - Uses Apple's modern
reviewSubmissionsAPI for submission cancellation. - Adds API-backed creation for localizations and pricing availability, plus encryption-exempt declarations.
- Adds auth-free public App Store commands for inspecting public storefront app data.
Improvements and fixes
- Adds regression coverage for web subscription refresh reporting.
- Adds Subbie to the Wall of Apps and refreshes the download badge.
0.44.2 (2026-03-20)
New features
- Adds
asc builds countfor a concise count of matching builds. - Adds
builds updatesupport for encryption compliance and a corresponding encryption check to submission preflight.
Improvements and fixes
- Adds build processing diagnostics to upload failures, distinguishing processing from terminal failure.
- Fixes TestFlight notification flows, skips redundant internal-group adds, and clarifies partial-notification failures.
- Preserves config-fallback credentials when switching the default auth profile.
- Clarifies demo-account-required review guidance.
- Adds signing git-store path and symlink regression coverage.
- Adds regression coverage for mutating request-limiter defaults and refreshes release badges.
- Adds Caliscool, Pop, Placify, Daily, Clip Jar, Music Plus, Inline, Beauty Fonts, and Dtd to the Wall of Apps.
- Adds MD Clock, MD Vinyl, MD Widgets, OffScreen, Appboard, Calorimeter, Scap, Menuist, and Quick RSS to the Wall of Apps.
- Adds DevTutor, Musicer, DevHub, Audioer, Videoer, Truessay, Tilt, SF Catalog, and QuickPhrase to the Wall of Apps.
0.44.1 (2026-03-17)
New features
- Adds
asc xcode validatefor checking an IPA before upload.
Improvements and fixes
- Aborts the web-auth password prompt cleanly on Ctrl+C.
- Recovers availability boolean parsing and renames pricing verbs to match the canonical command vocabulary.
- Hardens subscription availability and equalized-pricing flows.
- Strengthens web-auth fallback and snapshot regression coverage.
- Adds PrivaNota, Impulses, CUStats Go, Jinshu Reader, and CUStats to the Wall of Apps.
- Refreshes the downloads badge.
0.44.0 (2026-03-16)
New features
- Adds
asc xcode versionview, edit, and bump commands for project marketing and build versions. - Adds encrypted git-based signing sync for certificates and provisioning profiles.
- Adds
release pre-submitandsubmit preflightreadiness stages before App Review submission. - Adds app content-rights view/edit commands and an age-rating
--all-nonesafe-default option. - Adds exact-role web-auth capability lookup for accounts whose key role is needed by an operation.
Improvements and fixes
- Paginates pricing and pre-order territory-availability listings so large territory sets are not truncated.
- Warns when an App Store export uses a beta Xcode toolchain and waits for direct-upload exports to process.
- Handles tvOS direct-upload exports that produce a package without an IPA.
- Hardens review-submission status handling, quiets stale warnings, and adds actionable submission error hints.
- Adds pagination edge-case coverage for capability lookups and hardens launch onboarding/support documentation.
- Adds Space, Gradient Match Game, FaceScreen, Presentify, and KeyScreen to the Wall of Apps.
0.43.0 (2026-03-15)
New features
- Adds
asc auth issuer-idto print the configured App Store Connect issuer ID. - Adds a metadata-keywords workflow for inspecting and applying keyword data.
- Adds
asc builds dsymsto download dSYM artifacts for processed builds.
Improvements and fixes
- Suppresses expected 409 Conflict warnings when cancelling an already-stale submission.
- Avoids repeated keychain prompts during auth status and profile switching.
- Adds regression coverage for submit update-state preflight detection.
- Adds three Wall of Apps entries (WordFlux, Pico-8 Emulator, and Neurona).
0.42.0 (2026-03-14)
New features
- Adds sorting and app lookup support to Xcode Cloud build-runs.
- Adds
--run-idsupport for Xcode Cloud issues and artifacts tied to a specific build run. - Adds experimental private Xcode Cloud workflow-editor commands.
- Adds custom labels to
asc snitchreports.
Improvements and fixes
- Returns usage errors for invalid Xcode Cloud build-run flags and displays bundle IDs in the products table.
- Clarifies invalid web-auth credential errors and adds submit-create stale-detach regression coverage.
0.41.4 (2026-03-14)
New features
- Adds
asc auth tokento print the signed JWT for the selected auth profile, with the existing auth safeguards. - Recovers submit-create when a version is already attached to another submission.
- Automatically selects the editable app-info resource when an app has more than one.
Improvements and fixes
- Validates release tags before updating the Homebrew tap.
- Removes stale subscription-v2 and unused documentation/benchmark artifacts.
- Adds DreamWhisper and Masseter to the Wall of Apps.
0.41.3 (2026-03-13)
New features
- Adds a
--platformfilter tobuilds listand displays marketing version and platform in output. - Validates
whatsNewduring submit-create preflight.
Improvements and fixes
- Adds regression coverage for app-version state resolution.
- Adds Aseta, ulives, Photo Cleanup, and HabitMax to the Wall of Apps.
0.41.2 (2026-03-13)
New features
- Adds
--app-infoto metadata pull for apps with multiple app-info records. - Adds
--skip-existingand--replaceto screenshot uploads, allowing rerunnable synchronization without manual cleanup.
Improvements and fixes
- Fixes pre-order enable, update, and disable flows.
- Improves metadata version-state and terms validation.
- Removes the benchmark comment flow.
- Adds GrowPal, mojo, Box Box Club, GO Club, and Fix My Treadmill to the Wall of Apps.
- Adds Klick, Plushify, and FocusAir to the Wall of Apps.
0.41.1 (2026-03-13)
Improvements and fixes
- Simplifies Wall of Apps submission metadata so contributors provide the fields the submit command actually needs.
- Adds PaperlessHero, EduSwipe, Photo2Calendar, QuitNicPouches, Don't Spiral, Sharing Me, rawcast, and Constellation to the Wall of Apps.
- Adds murmur, Notch, Fermento, Visa Day Tracker, Lexie, Layered, Silk, and Glint to the Wall of Apps.
0.41.0 (2026-03-12)
New features
- Adds an app-availability bootstrap command for setting up storefront availability.
Improvements and fixes
- Aligns
review items addwith Apple's documented submission item types, avoiding requests rejected by the submission schema. - Allows
snitchissue filing when the token cannot manage labels. - Excludes territory resources from the availability create
includedarray so the relationship payload matches Apple's schema. - Adds regression coverage for review-history pagination edge failures.
- Adds four Wall of Apps entries: Petal, Protocol Zero, Sona, and Cal AI.
0.40.1 (2026-03-12)
New features
- Adds sandbox environment support to IAP offer-code generation.
- Adds
review submissions-historyfor inspecting App Review submission history.
Improvements and fixes
- Validates copyright, URL format, and conditional privacy-policy metadata before submission.
- Adds Cloak, Palabros, and FlipKit to the Wall of Apps.
0.40.0 (2026-03-12)
New features
- Adds local
asc xcode archiveandasc xcode exporthelpers with deterministic.xcarchiveand.ipapaths. - Smooths upload-processing waits in the same workflow.
- Adds workflow step outputs and resumable recovery so a failed workflow can continue from completed steps.
- Canonicalizes the IAP pricing command tree.
Improvements and fixes
- Renames raw linkage commands to
links, clarifying their role in the resource relationship surface. - Adds pagination and retryable-pricing regression coverage.
- Adds Loverzz, Zenther, SajdaTV, and Concert Memories 2 to the Wall of Apps.
- Adds SubList, SwiftyMenu, BuddyTask, and Bloom to the Wall of Apps.
Breaking changes
- The raw linkage naming is replaced by the canonical
linkssurface. - Scripts using the old linkage command names should migrate to
links.
0.39.1 (2026-03-11)
Improvements and fixes
- Validates release type and scheduled date in release configuration.
- Warns when subscription pricing does not cover every requested territory.
- Moves pre-release versions and beta-app localizations under the canonical TestFlight command taxonomy.
Breaking changes
- The preferred command home for pre-release versions and beta-app localizations is now
testflight; automation should follow the new help taxonomy and its compatibility guidance.
0.39.0 (2026-03-11)
New features
- Includes IAP review-readiness checks in unified validation.
Improvements and fixes
- Moves app-info workflows under
apps info, completing the app metadata home. - Sanitizes
BASH_ENVbefore workflow steps run, preventing inherited shell configuration from changing workflow behavior. - Finishes the canonical builds test-notes migration.
- Synchronizes the OpenAPI snapshot with App Store Connect API 4.3.
0.38.3 (2026-03-10)
New features
- Adds
asc subscriptions pricing equalizefor applying a consistent pricing shape across subscription territories. - Adds deep
MISSING_METADATAdiagnostics for missing subscription localization, image, or pricing data.
Improvements and fixes
- Adds Geeps: AI Chat BYOK to the Wall of Apps.
0.38.2 (2026-03-10)
New features
- Allows internal groups in
builds add-groups, removing an unnecessary TestFlight distribution restriction.
Improvements and fixes
- Adds regression coverage for Wall of Apps submission validation.
- Adds Ripple News, BitLocal, Sunbreak, and PeekaPaw to the Wall of Apps.
0.38.1 (2026-03-10)
New features
- Replaces the Wall generator with the
apps wall submitcommand.
Improvements and fixes
- Adds Smart Music Stations: Wavyy and Ryform Golf plus five apps from the community batch.
0.38.0 (2026-03-08)
New features
- Redesigns TestFlight command discovery around canonical workflows.
- Adds
iap setupandsubscriptions setupworkflows that create required product, localization, and pricing resources in sequence. - Standardizes the
[experimental]stability label across command surfaces.
Improvements and fixes
- Preserves screenshot order after uploads.
Breaking changes
- Replaces removed legacy subscription paths with V2 families under
subscriptions groups,pricing,offers, andreview. - V2 selectors include
--group-id,--subscription-id,--price-point-id, and--availability-id; scripts using removed paths must migrate.
0.37.3 (2026-03-07)
New features
- Adds bundle-ID and app-name resolution to crashes and status commands.
- Adds
asc snitchfor agent-driven friction reporting, with issue-triage guidance in the docs.
Improvements and fixes
- Includes IDs and resource-type labels when a beta group name is ambiguous.
- Guards remote webhook binds and symlinked asset paths.
- Fixes code-scanning workflow permissions and dismisses false-positive crypto alerts.
- Adds crash-lookup regression coverage and aligns release help, docs, and workflow examples.
- Adds Bibliostats, Cubby, and Chroma to the Wall of Apps.
0.37.2 (2026-03-06)
New features
- Adds
govulncheckand CodeQL workflows, including expanded custom CodeQL language coverage. - Adds terminal progress spinners to web-session commands.
- Adds phased-release progress output.
Improvements and fixes
- Improves the expired web-auth session cache UX.
- Adds validation coverage for retryable and transport-skip subscription-image paths.
- Adds 66-Day Streak, Thought Ease, SnaPOP, and ZenShelf to the Wall of Apps.
0.37.1 (2026-03-06)
Improvements and fixes
- Warns during validation when subscription promotional images need attention.
- Prunes repetitive low-signal tests.
- Adds HRM Battery, Prickly Pear, and Cat on Chair to the Wall of Apps.
0.37.0 (2026-03-05)
New features
- Adds
asc schemafor endpoint discovery by path, method/path, or dot notation. - JSON results include parameters, allowed values, request attributes, and response schema names;
--list,--method, and--prettysupport automation. - Adds
asc release runfor a deterministic version, metadata, build-attach, readiness, and review-submission pipeline. - Supports dry-run planning, structured step output, confirmation, strict validation, and checkpointed resume.
- Adds app-scoped build waiting so
builds waitcan discover a build before polling processing. - Adds batch app-info locale updates through
--localesor--from-dir. - Adds version metadata carry-forward for creating a new version from an existing version's metadata.
- Adds latest-build processing-state filters and localization shortcuts for build workflows.
- Adds an install-time notifier for stale cached ASC skills.
- Extends Xcode Cloud run triggers and adds build-runs lookup.
Improvements and fixes
- Rejects unsafe characters in API path segments before constructing requests.
- Fixes stale CLI examples in agent-facing docs.
- Adds Magic Sticker Printer, Quietude, Peakme, and FPLai to the Wall of Apps.
0.36.3 (2026-03-03)
New features
- TTY-aware output defaults: interactive terminals default to
table, while piped or redirected output defaults to minifiedjson; an explicit--outputstill wins. - Auth status renderers:
asc auth statusnow supports table and JSON output, plus--verboseand--validatefor inspecting and checking stored credentials. - Latest build selection:
asc builds latestresolves the latest processed build and the next build number, with--version,--platform,--next, and--exclude-expiredfilters. - Category subcategories: category updates accept
--primary-subcategory-one,--primary-subcategory-two, and matching secondary subcategory flags;asc categories subcategories --category-id ...lists valid IDs.
Improvements and fixes
- Metadata push resolves ambiguous localization targets more safely and validates app-info locales before updating.
- CLI usage errors and pagination loops were standardized.
- Wall of Apps entries, including Pickle Rite, Plinth.IT, Voice Do, and a multi-app submission, are listed in this release.
0.36.2 (2026-03-02)
Improvements and fixes
- Initial subscription pricing now uses PATCH with inline prices, matching Apple's accepted request shape for first-time pricing.
- App-event purchase requirements are normalized and known Apple 500 responses are guarded, producing a useful CLI result instead of an opaque failure.
- Finny was added to the Wall of Apps.
0.36.1 (2026-03-02)
New features
- Xcode Cloud usage alerts and persistence: usage alerts can report quota conditions, and web-session refresh state persists across commands.
- Xcode Cloud environment variables:
asc web xcode-cloud env-vars shared list|set|deletemanages shared variables for a product, using the web session. - Xcode Cloud workflows:
asc web xcode-cloud workflows describeinspects a workflow and the workflow commands can toggle its state.
Improvements and fixes
- Web auth resolves the cached session by default and removes
--password-stdin; account-context errors are clearer, and pricing availability set now requires--available-in-new-territories. - TickerPad, 시선, Fuel: AI Nutrition, and Dash were added to the Wall of Apps.
- Foundation Lab's TestFlight entry was updated.
February 2026
0.36.0 (2026-02-28)
New features
- Xcode Cloud usage reporting:
asc web xcode-cloud usage summary|months|days|workflowsreports plan quota and compute-minute usage, with monthly, daily, product, and workflow breakdowns. The commands use Apple's private CI API and a web session.
Improvements and fixes
- Webhook execution bounds and process lifecycle waits were fixed so local receivers handle event scripts within explicit limits.
- Weather mini, Popcorn Stack, Tamloot, and Torqs were added to the Wall of Apps.
Notes
- Xcode Cloud usage reporting is explicitly experimental, unofficial, and discouraged because it depends on Apple's private CI API.
0.35.3 (2026-02-28)
Improvements and fixes
- Game Center leaderboard-set
members-setnow works with empty sets and deduplicates member output across the v1 and v2 updater paths. - Contact Sheet and Siraj were added to the Wall of Apps; these community additions are listed in this release.
0.35.2 (2026-02-27)
New features
- Tier-based pricing resolution: price-point and schedule workflows accept
--tierand--price, letting callers resolve Apple's tier or customer-price value before creating a schedule.
Improvements and fixes
- Release CI's Wall snippet and pinned Koubou version were synchronized, the main branch release failure was fixed, and LivaLog and Planit were added to the Wall of Apps.
0.35.1 (2026-02-26)
Improvements and fixes
- Web follow-up requests deduplicate URL redaction and avoid a prompt-timeout regression.
- Web app creation preflights bundle IDs and accepts
UNIVERSAL, preventing a request that cannot succeed because its bundle ID doesn't exist.
0.35.0 (2026-02-26)
New features
- Price-point selection by customer price: schedule creation can select a price point by customer price instead of requiring a pre-resolved price-point ID.
- Web App Privacy workflow:
asc web privacy catalog|pull|plan|apply|publishprovides an agent-oriented workflow for private App Store Connect privacy declarations, including a plan/apply boundary. - macOS screenshot capture and framing: screenshot automation can capture macOS app windows and frame them for Mac App Store canvas sizes.
Improvements and fixes
- Web authentication falls back to an interactive password prompt, and 401 failures include debug diagnostics without exposing the password.
Notes
- The web privacy and authentication command groups use Apple's private web surfaces and are experimental/unofficial; the public API doesn't expose App Privacy declarations.
0.34.1 (2026-02-26)
Improvements and fixes
- Keychain authentication still works when the original
.p8file has been removed, allowing stored key material to be used for review-detail and app-creation flows.
0.34.0 (2026-02-25)
New features
- Web review context:
asc web reviewcan list and show App Review submissions, resolution-center threads, messages, rejections, and attachments.showcan download available screenshots and attachments to an output directory while redacting returned URLs. - Detached web auth and app creation: experimental Apple web-session authentication and app-creation commands moved under the detached web command group, separating private-web workflows from public API commands.
Improvements and fixes
- Web review validates submission states, prevents attachment filename path traversal, and removes the dead
allowLastparameter. Upload timeout hints and defaults were improved. - LilyFM was added to the Wall of Apps.
- Generated Wall spacing and snippet maintenance were updated.
0.33.2 (2026-02-25)
Improvements and fixes
- The issue audit shipped the high-value CLI changes identified in that review.
- Main CI now keeps the generated Wall of Apps count synchronized, and generated entries remain valid as community submissions are added.
- SnapVinyl, SwiftBiu, Progressio, and Reloop were added to the Wall of Apps.
0.33.1 (2026-02-24)
New features
- Family Sharing: IAP and subscription create/update commands now expose
--family-sharable, wiring Apple's family-sharing field into the CLI. - TestFlight agent workflows were improved across builds, notes, groups, and sync, with clearer command paths for automated use.
Improvements and fixes
- README guidance was reorganized around onboarding, and the Deep Hour, Reps, and Wozi community entries were added to the Wall of Apps.
0.33.0 (2026-02-23)
New features
- Pre-submission checks:
asc submit validateruns submission readiness checks before creating a review submission. - Direct localization updates:
asc localizations updateupdates app-info or version localization fields by locale, without preparing a metadata directory. - Price-point filters: price-point list commands accept exact, minimum, and maximum customer-price filters.
- Screenshot sizing now focuses default dimensions on iOS submission slots and includes newer iPhone 67/69 dimensions;
asc screenshotsexposes the expanded dimension data.
Improvements and fixes
- Stale review submissions are cancelled before a new one is created, and app-privacy API errors now include a hint for the web workflow because those declarations aren't available through the public API.
- Builds latest filtering, localization update formatting, and low-sample benchmark parsing were corrected.
- The release workflow trigger and agent documentation were refreshed.
0.32.0 (2026-02-22)
New features
- Slack release payloads: notifications can include
thread_tsand release-payload attachments, allowing release messages to remain in a Slack thread with structured metadata. - Custom product-page media: product-page workflows can upload and synchronize custom product-page media.
- Performance tooling: hot paths and pagination were optimized, and benchmark CI was added to track changes in command performance.
Improvements and fixes
- Asset helpers and localization ID handling were consolidated; Slack message text duplication and custom-page code issues were fixed. README onboarding now includes GitLab CI components and a clearer first-run structure.
0.31.3 (2026-02-21)
New features
asc localizations screenshot-sets deletedeletes a screenshot set by ID with the CLI's destructive-operation guard.- Added iPad Pro 13-inch (M5) screenshot dimensions to local validation.
Improvements and fixes
- Delete-path coverage was expanded, and the Wall of Apps README presentation was simplified.
- Positive was added as a community entry.
0.31.2 (2026-02-21)
New features
- Fastlane-parity metadata workflows: metadata pull/push and migration aliases use the fastlane directory layout, with
asc metadata pull,asc metadata push, andasc migratepaths sharing consistent locale and file resolution.
Improvements and fixes
- Metadata push now handles locale paths, default-locale casing, unused writers, file cleanup, validation, and app-info/version localization selection consistently.
0.31.1 (2026-02-20)
New features
- Screenshot and video-preview CDN downloads retry transient failures and send a curl-like user agent, improving reliability for automated asset pulls.
Improvements and fixes
- Asset download errors now retain useful context.
- The status dashboard labels a release “Needs Attention” only when a real blocker exists.
- Goshuin Atlas, Sticky Widgets, and KeepCount were added to the Wall of Apps.
0.31.0 (2026-02-20)
New features
- Account status:
asc account statusreports account-level state, optionally scoped with--app, in JSON, table, or Markdown output. - Weekly insights:
asc insights weekly --app "APP_ID" --source analytics|sales --week "YYYY-MM-DD"compares the selected week with the previous week; the sales source includes linked IAPs and subscriptions by matching the app SKU. - Subscription price import:
asc subscriptions prices import --id "SUB_ID" --input "./prices.csv"imports territory prices, with--dry-run,--start-date, and preservation controls for scheduled pricing.
Improvements and fixes
- Wall generation now sorts generated app entries alphabetically.
- Writone, Timefall, and other community additions were added to the Wall of Apps.
0.30.0 (2026-02-20)
New features
- Release status dashboard:
asc status --app "APP_ID"aggregates builds, TestFlight, App Store, submission, review, phased-release, and link signals into one deterministic payload;--includeselects sections and--output tablerenders it for review. - Local webhook receiver:
asc webhooks serve --port 8787 --dir ./webhook-eventsaccepts webhook events, persists payloads, and can execute a script for each event with--exec. - Localization diff: a deterministic diff command compares local metadata with App Store Connect data, making pending changes visible before a push.
- Embedded list/show guides were added to
ascdocumentation, and TestFlight beta-tester CSV compatibility was standardized.
Improvements and fixes
- Webhook serving rejects positional arguments and removes dead body-size code.
- Listener and process handling now wait for webhook processes correctly.
- Status uses positional beta-build matching only when one build and one detail make that fallback unambiguous.
- Date comparisons, diff UTF-8 truncation, and duplicate localization validation were corrected.
0.29.3 (2026-02-19)
New features
- TestFlight beta groups support internal groups on create and list.
asc testflight beta-groups list --app "APP_ID" --internalfilters app groups, and--global --internalqueries internal groups across apps.create --internalcreates an internal group.
Improvements and fixes
- A bad Homebrew tap token no longer fails the rest of the release workflow.
0.29.2 (2026-02-19)
Improvements and fixes
- Install help now points users to the repository's skills, while Inkput was added to the Wall of Apps.
0.29.1 (2026-02-19)
Breaking changes
- Startup update checks and self-update behavior were removed. Homebrew installations now follow Homebrew's update model, so users update with
brew upgrade.
Improvements and fixes
- Documentation now consistently calls the tool
ascand explains its unofficial status. Wall entries for Bobbin, ToMe, and Plinky are recorded in the release notes.
0.29.0 (2026-02-18)
New features
- Relationship endpoints: added the missing relationship list, get, and mutation routes across apps, bundle IDs, Game Center, builds/TestFlight, metadata, subscriptions, IAP, pricing, and Xcode Cloud. This makes related resources reachable without raw API calls.
- Workflow execution: the workflow command gained enterprise hardening for JSON runs, including safer handling of command output and process results.
Improvements and fixes
- Relationship request validation now rejects empty mutation arrays and aligns bundle, app, and Game Center relationships with the production API contract.
0.28.14 (2026-02-18)
Improvements and fixes
- Fastlane metadata import skips non-locale directories such as review-information folders instead of treating them as localizations. macOS path comparison coverage was corrected around the fix.
0.28.13 (2026-02-17)
New features
- Added a setup GitHub Action for repository automation.
- Added a daily analytics snapshot workflow.
- Video Annotation joined the Wall of Apps.
Improvements and fixes
- CI now enables
misspell,unparam, anderrorlintin phases so lint findings can be addressed incrementally.
0.28.12 (2026-02-17)
New features
- Generated release notes: release notes can be generated from git history, with output suitable for text and Markdown consumers.
Improvements and fixes
- Release-note text and Markdown output no longer duplicate content, and
--max-chars 0is handled correctly. Error strings were normalized for staticcheck, and the lint issue limit was restored for CI.
0.28.11 (2026-02-17)
New features
- Paginated commands show a GitHub-style spinner on stderr while pages are fetched, keeping progress visible without contaminating stdout data.
Improvements and fixes
- Added Parsely to the Wall of Apps; the community-only entry is covered by this release.
0.28.10 (2026-02-16)
Improvements and fixes
- Added Mixtape app details to
wall-of-apps.json. - Removed stale
ASC.mdso generated agent guidance cannot use obsolete repository instructions.
0.28.9 (2026-02-16)
New features
- Local provisioning-profile management:
asc profiles localadds local install, list, and clean workflows; profiles can also be downloaded from App Store Connect. - Certificate requests:
asc certificates csr generatecreates a certificate signing request from the CLI. - Screenshot plans accept JSONC comments, which keeps annotated automation plans valid.
Improvements and fixes
- Profile and certificate file writes were hardened against path traversal, orphaned key files, unsafe permissions, and local edge cases. The local profile commands also fixed their reported edge cases, and force-overwrite paths apply an explicit restrictive umask.
0.28.8 (2026-02-16)
New features
- TestFlight CSV exchange: beta testers can be exported to and imported from CSV, with standardized validation and compatibility handling for automation.
- Media downloads: screenshots and video previews can be downloaded from their CDN URLs, with shared asset download helpers and transient-failure handling.
Improvements and fixes
- TestFlight summaries now report accurate values, and asset downloads handle context errors more cleanly.
0.28.7 (2026-02-16)
Improvements and fixes
- Submission readiness checks now cover empty build data, category values, and screenshot requirements.
0.28.6 (2026-02-15)
Improvements and fixes
- Corrected
whatsNewvalidation for version 1.0 releases, where the initial release has different metadata requirements.
0.28.5 (2026-02-15)
Improvements and fixes
- Added arunavo4's apps to the generated Wall of Apps metadata.
0.28.4 (2026-02-15)
Improvements and fixes
- Wall generation was repaired after the Dandelion entry exposed duplicate
WallEntrydefinitions and a generation issue. - The Dandelion community entry is included in this release.
0.28.3 (2026-02-14)
Improvements and fixes
- Stale update checks run asynchronously, reducing startup work for commands that don't need update information.
0.28.2 (2026-02-14)
Improvements and fixes
- Koubou is pinned to
v0.13.0for repeatable local screenshot framing. - The CLI checks the installed version before
asc screenshots frameand watch generation. - Missing or mismatched
kouversions return a clear error. - Documentation includes
pip install koubou==0.13.0.
Notes
- Local screenshot automation remains experimental; callers should pin the tool version with the CLI.
0.28.1 (2026-02-14)
Notes
- Local screenshot commands are explicitly marked experimental:
asc screenshots run,capture,frame, andlist-frame-devices. - Review commands
review-generate,review-open, andreview-approveare also experimental and may change.
0.28.0 (2026-02-14)
New features
- Local screenshot workflow:
asc screenshotsadds capture, framing, device listing, review generation, review opening, and approval commands. Koubou provides deterministic framing for generated App Store screenshots; the local workflow remained experimental. - Top-level
asc screenshotsandasc video-previewscommands are wired into the command tree, with media-asset wording and root help updated accordingly.
Improvements and fixes
- Uploads now use the configured upload timeout, including asset file uploads.
- Auth output redacts environment identifiers;
ASC_STRICT_AUTHaccepts explicit yes/no values and warns on unsupported values, whileASC_BYPASS_KEYCHAINhandles an empty setting consistently. Keychain migration cleanup and credential removal were tightened for test isolation. - IPA, profile, and other file paths reject symlink escapes across Unix and non-Unix platforms. Submit cancellation routes to the review-submission ID, and exit-code behavior is consistent across commands.
- Release binaries are stripped with
-s -w, dead command wrappers were removed, and async/await support was added to the internal App Store Connect client.
0.27.0 (2026-02-11)
New features
- Pre-submission validation:
asc validatenow checks the App Store version, app metadata, localizations, screenshots, and age-rating declaration, emits a structured report, and returns a reported error when blocking issues exist. - Metadata migration: fastlane import handles the complete metadata layout, including app-info and version localizations, while
asc initcan refreshASC.mdguidance. - Screenshot and build checks: validation checks screenshot dimensions and presence; build latest/next-number selection was corrected for the current release state.
Improvements and fixes
- Shared validation, metadata helpers, migration screenshot logic, and age-rating error messages were consolidated so the new checks report consistent failures.
0.26.4 (2026-02-11)
Improvements and fixes
- API errors now surface Apple's
associatedErrorsdetails alongside the primary error, making nested validation failures visible to callers. - Wall of Apps metadata was refocused on community supplied data; the Repetti, TV Show Tracker, and Unlimited Clipboard History entries are listed in this release.
0.26.3 (2026-02-11)
New features
- Added
asc apps walland generated Wall of Apps metadata, with contribution flow and platform handling for community app entries. asc auth doctorreports migration hints, including array-shaped hints when more than one action is needed.- Subscription price-point equalizations accept
--paginatefor complete result sets.
Improvements and fixes
- The project moved to Go 1.26. Wall entries for DoubleMemory and Kora are included in this release.
0.26.2 (2026-02-10)
New features
- IAP offer-code generation: offer-code creation now has the pricing and eligibility inputs needed to generate codes for in-app purchases.
- Game Center mutations: Game Center resource groups gained the mutating endpoints needed to create or update resources, and the enabled-version pointer is handled on
GameCenterAppVersion. - Bundle ID capability updates: bundle ID capability records can be updated through the CLI.
- List commands were brought to endpoint parity, including consistent app-ID flag validation.
0.26.1 (2026-02-10)
New features
- Age-rating declarations are fully handled by the metadata and submission paths, and initial releases can carry
whatsNewcorrectly. - Added the repository Hall of Fame and a new Wall of Apps entry for MileIO.
Improvements and fixes
- Output cleanup was deferred through the command lifecycle, and update/reporting paths were hardened while zero-coverage packages were removed.
0.26.0 (2026-02-09)
New features
- CI and test reporting: commands can return meaningful CI exit codes and write JUnit reports with the new report flag, giving pipeline runners a machine-readable test result.
Improvements and fixes
- The release history includes a revert and follow-up around the CI/report implementation; consult the release notes when pinning behavior for a pipeline.
0.25.4 (2026-02-08)
Improvements and fixes
- Markdown output now uses tablewriter's renderer, keeping table and Markdown formatting on the same output path.
PrintTableandPrintMarkdowntype switches were replaced with an output registry, so renderers are registered by output type rather than maintained in a central switch.- The install script was aligned with versioned release asset names; table rows were also left-aligned for terminal readability. These maintenance changes are covered by this release.
0.25.3 (2026-02-08)
New features
- Notification payloads can now include Slack Block Kit content, allowing structured Slack messages from CLI workflows.
ASC_DEFAULT_OUTPUTsets the default renderer for scripts and shells that don't pass--output.
Improvements and fixes
- Replaced the tabwriter table path with tablewriter so bordered table output is consistent across commands. Shared wrapper re-exports and pre-stat file checks were removed as part of the cleanup.
0.25.1 (2026-02-07)
New features
- Consolidated IAP pricing:
asc iap prices --app "APP_ID"or--iap-id "IAP_ID"summarizes current price, proceeds, base territory, and scheduled changes;--territorynarrows app-level results. - Subscription price-point queries and pricing support were expanded, including territory-aware lookup and pagination paths.
Improvements and fixes
- Fastlane metadata import now omits
localefrom PATCH payloads and selects the draft orPREPARE_FOR_SUBMISSIONApp Info record instead of relying on an arbitrary record. Follow-up hardening keeps that selector consistent. - The release also cleared the lint backlog in batches and added the canonical repository URL to the README and agent guidance.
0.25.0 (2026-02-06)
New features
- macOS notarization adds
asc notarization submit --file <path>for.zip,.dmg, and.pkgfiles. - Uploads use SHA-256 handling and Apple's Notary API v2.
--waitpolls to completion;--poll-intervaland--timeoutcontrol the wait.status,log, andlistinspect existing submissions.
Improvements and fixes
- Notarization wait status reports progress, timeout, and failure guidance, including the command to retrieve the developer log.
0.24.3 (2026-02-06)
Improvements and fixes
- Release assets were renamed to follow GitHub CLI naming conventions, keeping downloaded artifact names consistent with the release tooling.
0.24.2 (2026-02-05)
New features
asc publishcan resolve a TestFlight beta group by its name or ID, so publishing workflows can accept the identifier operators already have.
Improvements and fixes
- Corrected a false “ambiguous group” result and fixed a nil-pointer panic in pagination.
0.24.1 (2026-02-03)
New features
- TestFlight gained the missing command endpoints from the release audit, including the corresponding command wiring.
- Certificate activation can be toggled from the CLI.
- Analytics report requests can be deleted.
Improvements and fixes
- Added CLI-level coverage for the TestFlight commands and corrected their help indentation.
- The README now positions
ascas a scriptable IDE/terminal CLI.
0.24.0 (2026-02-02)
New features
- Game Center enabled-version queries:
asc game-center enabled-versions list --app "APP_ID"lists enabled versions, andcompatible-versions --id "ENABLED_VERSION_ID"lists versions compatible with a multiplayer matchmaking configuration. asc testflight metrics beta-tester-usages --app "APP_ID"fetches beta tester usage metrics.--periodselects a supported reporting window;--group-by betaTestersand--filter-tester "TESTER_ID"scope the result.asc testflight beta-crash-logs get --id "CRASH_LOG_ID"fetches an individual crash log.- IAP and subscription pricing lookups: IAP offer-code prices and price-schedule base territories can be read directly, and one-time subscription offer-code access is split into explicit
listandgetcommands. - ID-scoped pricing and media-set queries: pricing schedule and availability can be fetched by
--id, and preview or screenshot sets can be fetched by set ID instead of first resolving the parent localization.
Improvements and fixes
- Enabled-version commands no longer perform redundant output validation.
0.23.5 (2026-02-02)
New features
- Subscription grace-period support adds the subscription configuration data needed to represent Apple's grace-period settings.
0.23.4 (2026-02-02)
New features
-
app-setup info setaccepts a content-rights declaration, so setup can configure the same declaration exposed byapps update. -
Startup update checks notify users when a newer CLI release is available.
Improvements and fixes
-
Destructive removal commands now require explicit confirmation before deleting resources.
-
Self-update downloads now identify the client with a User-Agent and close temporary files on error paths, improving compatibility and cleanup.
0.23.3 (2026-02-01)
New features
-
builds uploadaccepts--pkgfor macOS installer packages. -
app-infos listdiscovers app-info IDs needed by metadata and declaration workflows. -
review submissions-cancelcancels draft review submissions. -
apps updateaccepts a content-rights declaration.
Improvements and fixes
builds listreportsusesNonExemptEncryptionas required, exempt, or not applicable, making encryption status visible without inspecting raw API data.
0.23.2 (2026-02-01)
New features
- App Clip image get commands retrieve metadata and URLs for existing App Clip image resources.
0.23.1 (2026-02-01)
Improvements and fixes
- Development tooling adds a safe format/lint fallback when optional tools are unavailable.
January 2026
0.23.0 (2026-01-31)
New features
-
--debugandASC_DEBUGenable HTTP tracing for diagnosing requests and responses. -
TestFlight build relationships, beta feedback, and beta-recruitment criteria filters expose more of Apple's beta-testing data.
-
App-info category, encryption-declaration, and territory age-rating relationships are available for app metadata workflows.
-
Game Center parity expands app versions and details, v1 relationships/metrics/images, and v2 achievements, leaderboards, and leaderboard sets.
-
App Clips and App Store version relationships, plus customer reviews, are exposed through the CLI.
-
Relationships for IAPs, subscriptions, pricing, offer codes, bundle IDs, agreements, CI products, background assets, and visible apps cover common commerce and distribution lookups.
Improvements and fixes
-
Next-page parsing for bundle IDs and Game Center details now follows the API's pagination links reliably.
-
Pricing schedule and availability IDs receive stricter validation before requests are sent.
-
Background-asset output and debug logging were refactored for clearer, safer output; HTTP flags are split so tracing options do not accidentally alter request behavior.
0.22.1 (2026-01-31)
New features
-
TestFlight beta-license agreement and notification resources can be managed from the CLI.
-
Game Center submission endpoints are available for submission-related workflows.
-
Customer-review summarizations can be retrieved.
0.22.0 (2026-01-31)
New features
-
Subscription sub-resources and in-app-purchase sub-resources expand resource-level management beyond the parent records.
-
Offer-code commands and per-territory pricing commands support localized commerce configuration.
-
Build/TestFlight operations gain sandbox parity, covering the same build relationships in the sandbox API surface.
-
Screenshot validation recognizes Apple's 6.9-inch iPhone display type.
Improvements and fixes
-
Subscription offer-code price payloads are sent using the corrected relationship shape.
-
Game Center activity handling tolerates a missing activity version instead of failing while decoding the response.
0.21.0 (2026-01-30)
New features
-
App metadata keyword relationships can be listed and managed.
-
Analytics resources can be fetched directly by ID as well as through relationship listings.
-
Xcode Cloud SCM endpoints expose source-control connections and related resources.
-
Game Center coverage adds challenges, activities, groups, and matchmaking resources.
Improvements and fixes
- Analytics relationship IDs are validated as UUIDs before API calls.
0.20.2 (2026-01-30)
New features
-
Webhook delivery relationships and pagination are available for inspecting delivery records.
-
notify slacksends CLI notifications through a Slack webhook. -
Review submission and review-item resources can be queried.
-
In-app event localizations and media relationships are exposed.
-
Account signing relationships and user-visible-app relationships are supported.
-
Product-page localization keywords and media sets can be listed with pagination.
-
App Clip domain status relationships are available.
Improvements and fixes
-
Slack webhook handling is hardened, relationships pagination is validated, and next-page links now extract IDs correctly for user-visible apps.
-
App Clip domain support received follow-up cleanup alongside the relationship addition.
0.20.1 (2026-01-30)
Improvements and fixes
- The release improves command-line usability; the release record does not describe the individual interaction changes further.
0.20.0 (2026-01-30)
New features
-
Webhook commands manage webhook configurations.
-
App Clip commands cover App Clip resources and their API relationships.
-
Product-page commands manage product-page resources.
-
In-app-event commands manage in-app-event resources.
Improvements and fixes
- Client pagination handles additional
typeOfcases, JSON output preserves intentional zero values, and client experiments validate IDs before use.
0.19.3 (2026-01-29)
New features
- Marketplace search detail requests can select supported fields, reducing responses to the data callers need.
0.19.2 (2026-01-29)
New features
- Alternative-distribution package resources can be inspected and managed through the CLI.
Improvements and fixes
- Alternative-distribution output and client code were cleaned up for the new surface.
0.19.1 (2026-01-29)
New features
- Background-asset commands list and manage paginated background-asset resources.
0.19.0 (2026-01-29)
New features
-
Android-to-iOS mapping commands expose mappings used to connect Android and iOS apps.
-
Win-back offer commands support subscription win-back configuration.
-
reviews ratingsreports App Store rating statistics. -
Marketplace, merchant-ID, promoted-purchase, and pass-type-ID resources are available through dedicated CLI commands.
Improvements and fixes
-
Sandbox tester create/delete commands were removed because they are not supported by the current API surface.
-
Review output handles formatting more consistently, finance output preserves zero paid-month values, and pagination handles additional
typeOfcasing. -
Authentication/configuration and dependencies were refreshed and hardened.
Breaking changes
- Scripts that call the removed sandbox tester create/delete commands must migrate to the operations still supported by App Store Connect.
0.18.2 (2026-01-29)
New features
install skillsinstalls the ASC workflow skills pack used for release, TestFlight, metadata, and related workflows.
Improvements and fixes
-
Keychain defaults and config defaults are reconciled consistently, including when keychain credentials are present.
-
Keychain bypass validation is consistent, tests isolate authentication config, and unused type definitions are removed.
0.18.1 (2026-01-29)
Improvements and fixes
auth statusmerges keychain and configuration values before reporting credential status.
0.18.0 (2026-01-29)
New features
-
Game Center commands cover achievements, leaderboards, leaderboard sets, and their supported localizations.
-
auth status --validatevalidates stored credentials over the network and reports failures.
Improvements and fixes
-
Commands were reorganized by domain, making related command groups easier to discover and maintain.
-
Pagination, error handling, and temporary key cleanup were hardened; authentication values are handled strictly.
-
Game Center request and response types were aligned with the OpenAPI contract, and leaderboard-set localization names are validated.
-
Repository-local agent skills were removed as the project moved workflow skills to the maintained external pack.
0.17.0 (2026-01-28)
New features
-
Build-bundle commands expose the bundles associated with uploaded builds.
-
Pre-order commands manage pre-order availability and pricing.
-
Nominations commands expose nomination resources and their paginated collections.
-
App encryption declaration commands manage export-compliance declarations.
-
App asset commands manage App Store assets, and
app-setupcan run post-create automation. -
Xcode Cloud artifacts, test results, issues, expanded workflow coverage, and routing coverage can be queried.
-
Performance metrics and diagnostics, actors list/get commands, and apps get/update commands are available.
Improvements and fixes
-
Pre-order availability and Xcode Cloud list logic were corrected, duplicate list flags were consolidated, and performance output/download handling was improved.
-
Command logic and pagination types were consolidated for more consistent behavior.
-
App-setup command issues were corrected as the setup workflow expanded.
0.16.0 (2026-01-27)
New features
-
EULA commands manage app-level end-user license agreements.
-
Accessibility declaration commands manage accessibility information for app versions.
-
App tags, App Store version promotions, and version release requests are supported.
-
Review-submission commands cover App Store review submission operations, using one unified review command surface.
Improvements and fixes
- EULA app-ID resolution and accessibility helper reuse were corrected, and tests use stable typed assertions rather than matching error strings.
0.15.0 (2026-01-27)
New features
-
IAP and subscription commands cover the core product, group, and pricing operations.
-
The repository includes an offline OpenAPI snapshot and endpoint-index tooling, allowing endpoint and schema work without relying on a live documentation page.
Improvements and fixes
- Subscription creation uses the API's
grouprelationship name, and unused IAP/client code was removed or validated.
0.14.0 (2026-01-26)
New features
-
Bundle ID capabilities can be listed and configured.
-
Signing files can be fetched for local signing workflows.
Improvements and fixes
-
Signing profile and certificate handling, filename sanitization fallbacks, and tvOS in-house distribution inference were corrected.
-
Agents.mdreferences the maintained workflow skills and their progressive-disclosure guidance.
0.13.0 (2026-01-26)
New features
-
Auth profiles can be switched explicitly, allowing separate App Store Connect credentials to be selected for different projects or teams.
-
Offer-code resources are available through dedicated CLI commands.
-
Age-rating declarations can be configured from the CLI.
Improvements and fixes
- Credential names are normalized, resolution errors are clearer, profile mismatches are detected, and listing/default selection agree across flags and storage.
0.12.4 (2026-01-26)
New features
-
Authentication can read a private key from environment variables for headless CI use.
-
App-info metadata commands manage metadata fields through the app-info resource.
Improvements and fixes
- App Store version output includes the version date.
0.12.3 (2026-01-26)
New features
auth init --openopens the authentication setup flow for interactive setup.
Improvements and fixes
- The README gains a table of contents for faster navigation.
0.12.2 (2026-01-26)
New features
-
builds expire-allexpires multiple builds in one operation. -
Device management commands cover registered App Store Connect devices.
Improvements and fixes
- Upload-client transport assertions and audit fixes improve request safety and make regressions easier to catch.
0.12.1 (2026-01-25)
New features
- TestFlight beta-build localizations support “What to Test” notes.
Improvements and fixes
-
Build uploads wait longer for processing, reducing premature timeout failures.
-
Pagination handles the API's additional
typeOfvalues.
0.12.0 (2026-01-25)
New features
-
Categories can be listed and set.
-
App Store versions can be created, updated, and deleted.
-
Xcode Cloud action commands expose workflow actions.
-
Users and invitations can be managed from the CLI.
-
TestFlight beta distribution commands support tester and build rollout operations.
Improvements and fixes
- App Store submission now uses the
reviewSubmissionsAPI correctly.
0.11.0 (2026-01-25)
New features
-
The publish workflow connects build, upload, version, and submission stages into one end-to-end command flow.
-
Auth config initialization supports selecting credential storage.
-
The repository provides the ASC workflow skills pack for release and operational tasks.
Improvements and fixes
- Empty config values no longer become phantom credentials during authentication.
0.10.2 (2026-01-24)
New features
- App pricing and availability commands configure price schedules and territory availability.
Improvements and fixes
- Pricing schedule output formatters and client cleanup make the new pricing surface consistent with other commands.
0.10.1 (2026-01-24)
Improvements and fixes
- Maintenance release updates the README footer attribution; the release metadata lists no behavior change.
0.10.0 (2026-01-24)
New features
-
builds latestfinds the latest build with platform filtering; version filters enforce the platform limit. -
Build upload supports the full upload flow, including processing and checksum handling.
-
Customer reviews can receive responses.
-
App Store version phased-release management is available, with dedicated output formatting.
Improvements and fixes
-
Upload channel deadlocks and unused retry options were removed, and build upload handles empty checksums safely.
-
Finance report type mappings are documented and validated, beta-group boolean updates are handled correctly, and review star ratings are validated.
-
Large command files were split and localization downloads were improved for maintainability and more reliable retrieval.
-
Contributor guidance was reorganized around progressive disclosure for agent-assisted repository work.
0.9.0 (2026-01-24)
New features
- Finance report commands retrieve App Store Connect financial reports, with JSON fields matching the API response.
Improvements and fixes
- Credentials use the default keychain and legacy entries are migrated, reducing setup differences between existing and new installations.
0.8.1 (2026-01-24)
Improvements and fixes
- Improves IPA plist parsing and makes upload retry behavior more observable.
0.8.0 (2026-01-23)
New features
-
Beta groups and testers can be managed, including tester details, group relationships, and build-to-group relationships.
-
TestFlight apps and pre-release versions can be listed and inspected.
-
Build localizations and TestFlight YAML configuration support distribution workflows.
Improvements and fixes
- TestFlight command registration and generated documentation were refreshed to match the expanded command surface.
0.7.0 (2026-01-23)
Improvements and fixes
-
Security and beta-group handling were hardened.
-
Delete command output includes the message ID returned by the operation.
0.6.0 (2026-01-23)
New features
- Xcode Cloud commands trigger workflows and monitor their processing status from the CLI.
0.5.0 (2026-01-21)
New features
--paginatefollows collection next links and aggregates every supported page into one result.
0.3.1 (2026-01-21)
Improvements and fixes
- Sandbox tester password validation trims accidental leading and trailing whitespace before checking the value.
0.3.0 (2026-01-21)
New features
- Sandbox tester commands create, list, inspect, update, and delete supported App Store Connect sandbox accounts.
0.2.0 (2026-01-21)
New features
-
Beta groups and testers can be created, listed, updated, and removed, with dedicated output handlers.
-
Localization commands manage localized App Store content.
-
Submission workflows and version commands provide the initial release-preparation path.
-
Analytics and sales-reporting commands retrieve App Store Connect business data.
Improvements and fixes
-
Missing submission lookups are handled explicitly instead of producing an unusable result.
-
Homebrew tap automation and installation instructions were updated.
0.1.6 (2026-01-20)
New features
- Feedback commands retrieve screenshots attached to App Store Connect feedback submissions.
0.1.5 (2026-01-20)
Improvements and fixes
- Maintenance release that updates release automation to commit Homebrew tap changes using the personal Git identity. The release metadata lists no user-facing CLI behavior change.
0.1.4 (2026-01-20)
Improvements and fixes
- Credential resolution checks the system keychain before environment variables when both provide values.
Breaking changes
- Environments that intentionally relied on an environment variable overriding an existing keychain value must remove or update the keychain entry.
0.1.3 (2026-01-20)
Improvements and fixes
- Improves help output styling and removes duplicate usage text.
0.1.2 (2026-01-20)
New features
- macOS release binaries are code-signed, and the release workflow imports the Apple Developer ID certificate needed for signing.
0.1.0 (2026-01-20)
New features
-
The core CLI foundation provides App Store Connect API access with keychain authentication.
-
Output supports minified JSON for automation alongside human-readable formats.
-
Pagination and filters establish the initial collection-query behavior, while build commands cover build information and expiration.
-
Build upload and submission planning, checksum verification, and the local
bininstallation path provide the first release workflow.
Improvements and fixes
- Release tags use the
0.x.ynaming convention without a leadingv.