Blitz: Phi công tự động gửi app lên App Store (macOS)

TL;DR

• Tự động gửi app lên App Store bằng agent MCP
• Điều khiển simulator, upload ảnh, IAP, TestFlight
• Yêu cầu macOS và Xcode để build
• Thích hợp dev iOS cần agent-driven submission
• Kiểm tra checksum và audit installer trước khi cài

Một đêm trước release, tôi ngồi đối diện chiếc máy tính, deadline ép, người test báo thiếu screenshot, và anh reviewer vẫn chửi vì IAP chưa attach. Tôi thở dài, nghĩ về một bộ điều khiển tự động mà mình có thể giam vào tay một con bot cho nó lo hết, rồi nhớ tới Blitz. Câu chuyện ngắn thôi: chiếc máy bay (app) sắp cất cánh, phi công ngủ gật, Blitz là một tay “phi công tự động” bạn có thể bật lên để nó lái nửa chặng; bạn vẫn phải kiểm tra động cơ trước khi cất. (Hình gợi ý từ README: Blitz là app macOS với MCP server để agent làm submission, upload, IAP và screenshot) (research-vi).

Một câu neo (intern-friendly)

Repo này làm một app macOS có MCP server để agent tự động hoá quy trình gửi App Store, nhằm giảm thao tác thủ công khi upload assets, quản lý IAP, chạy simulator và submit phiên bản. (the README).

Show - Tình huống thực chiến (một loạt mẫu)

• Mẫu A - Chạy nhanh bản debug để thử GUI và simulator: clone + build debug, mở app và cho agent thử tương tác (npm run build:app:debug). (the README)
• Mẫu B - Tạo release và verify binary: bash scripts/bundle.sh release → tạo .app, so khớp SHA256 với SHA256SUMS.txt. (the README)
• Mẫu C - Agent-driven submission: bật Blitz, cho Claude Code kết nối MCP, agent fill form + upload screenshot + trigger submit. (research-vi)
• Mẫu D - Quản lý screenshots đa locale: agent gọi screenshots_put_track_slot / screenshots_save để đẩy ảnh theo track. (research-vi)

Zoom walkthrough - trước / sau (debug build)

Trước (thủ công, vài bước GUI):

1. Mở Xcode, chọn scheme, Product → Archive
2. Upload bằng App Store Connect web hoặc Transporter
3. Điền metadata, attach screenshot thủ công

Sau (Blitz + local debug):

git clone https://github.com/blitzdotdev/blitz-mac.git
cd blitz-mac
git submodule update --init --recursive           # chuẩn bị deps
npm run build:app:debug                            # build debug → mở .build/Blitz.app
# output: "Build complete. Opened .build/Blitz.app"

The Guts - dùng thật, từng lệnh một

git clone https://github.com/blitzdotdev/blitz-mac.git
cd blitz-mac
git submodule update --init --recursive
npm run build:app:debug  # opens .build/Blitz.app

bash scripts/bundle.sh release
sha256sum .build/Blitz.app

cp .env.example .env  # fill Apple credentials for signed builds

💡 Tip: nếu chỉ kiểm thử UI/agent flow, npm run build:app:debug rút ngắn thời gian hơn build-release. (research-vi)

⚠️ Warning: release builds có thể chứa telemetry và auto-update; audit installer scripts trước khi cài trên máy production. (research-vi)

Markdy scene - release night drama

Where it fits

• Audience: dev iOS/macOS cần giảm thao tác submit thủ công; thích hợp cho QA hoặc CI chạy trên macOS runners. (research-vi)
• Works with: App Store Connect API, bundled asc-cli, Claude Code / Codex MCP clients, Xcode toolchain. (research-vi)

Reality check

1. Platform lock: Blitz là native macOS - nếu bạn cần cross‑platform CI/CD không chạy trên macOS, Blitz không giúp được. (research-vi)
2. Installer & updater: release build có updater/installer; audit postinstall/pkg-scripts trước khi cài. (research-vi)
3. Docs fragmentation: repo tham chiếu nhiều docs (docs/*) nhưng snapshot này không kèm toàn bộ file - đọc README + docs listing trước khi chạy. (research-vi)

Quick install steps

1. git clone https://github.com/blitzdotdev/blitz-mac.git → cd blitz-mac. (research-vi)
2. git submodule update --init --recursive
3. npm run build:app:debug - mở .build/Blitz.app để test agent flows. (research-vi)
4. bash scripts/bundle.sh release → verify SHA256. (research-vi)

Final thoughts

Blitz giúp tự động hoá nhiều thao tác App Store nhưng không thay thế trách nhiệm của người release - luôn verify builds and audit installers.

blitzdotdev/blitz-mac · Apache-2.0 · 1369 · docs