appstore-flow

📝

YAML-first

Pull every per-locale listing, IAP catalogue, subscription, and screenshot summary into committed YAML. Edit in your editor; sync back.

🔄

Two-way reconcile

Field-level diff with paths like `subscriptions/my_sub/intro_offers/.../start_date`. Pull updates without clobbering local edits.

🤖

Bundled MCP server

Same client code, exposed over stdio. Any MCP-aware agent (Claude Code, Cursor, Cline, Windsurf) can read and update live store state.

💰

Price + subscriber migrations

Migrate existing subscribers when a price changes via Apple's `batchMigratePrices`. Dry-run by default; `--confirm` to fire.

⚡

One install, two binaries

Single `npm install`, two binaries (`appstore` + `appstore-mcp`). Configurable for any iOS project via env vars or `appstore-cli.config.yaml` (legacy config-file name from before the npm rebrand).

🌍

Locale-aware

Built and battle-tested on Lazy Sudoku's 14-locale listing and 173-territory pricing matrix.

What it does

appstore-flow puts your iOS store presence under version control. Instead of clicking through App Store Connect's per-locale tabs to update copy, prices, or screenshots, you pull live state into committed YAML, edit it in your editor, and sync it back through normal PR review.

The bundled appstore-mcp server exposes the same client code over stdio so any MCP-aware agent — Claude Code, Cursor, Windsurf, Cline, Continue, Zed — can read and update live store state without shelling out.

Quick install

bash

npm install -g appstore-flow
# or, from a checkout (the GitHub repo is still `appstore-cli` —
# only the npm package name has been rebranded to `appstore-flow`):
git clone https://github.com/zmij/appstore-cli.git
cd appstore-cli && npm install && npm run build && npm link

Then see Get started for the first-run walkthrough.

In production

I built this to manage Lazy Sudoku's App Store listing — 14 locales, 12 IAP products across 173 territories of pricing, plus subscription groups with intro offers. Editing YAML in my editor and running appstore listings sync / appstore iap sync is dramatically less error-prone than clicking through App Store Connect's per-locale tabs, and lets every store change land via normal PR review.

— Sergei Fedorov, Lazy Sudoku

Using appstore-flow somewhere? Open a PR adding yourself to the Adopters section in the README.

appstore-flowApp Store Connect from your terminal