{"id":48440907,"url":"https://github.com/blitzdotdev/app-store-review-agent","last_synced_at":"2026-04-06T15:04:31.655Z","repository":{"id":345616941,"uuid":"1186686853","full_name":"blitzdotdev/app-store-review-agent","owner":"blitzdotdev","description":"Agent that catches App Store submission rejections before real Apple reviewers do. ","archived":false,"fork":false,"pushed_at":"2026-03-19T22:29:00.000Z","size":42,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-20T13:33:28.752Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://blitz.dev","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blitzdotdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-19T22:16:31.000Z","updated_at":"2026-03-20T01:59:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blitzdotdev/app-store-review-agent","commit_stats":null,"previous_names":["blitzdotdev/app-store-review-agent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/blitzdotdev/app-store-review-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blitzdotdev%2Fapp-store-review-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blitzdotdev%2Fapp-store-review-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blitzdotdev%2Fapp-store-review-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blitzdotdev%2Fapp-store-review-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blitzdotdev","download_url":"https://codeload.github.com/blitzdotdev/app-store-review-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blitzdotdev%2Fapp-store-review-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31477014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T14:34:32.243Z","status":"ssl_error","status_checked_at":"2026-04-06T14:34:31.723Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-06T15:04:04.064Z","updated_at":"2026-04-06T15:04:31.638Z","avatar_url":"https://github.com/blitzdotdev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reviewer\n\nAI agent that role-plays as an Apple App Store Reviewer. Catches rejections before Apple does.\n\n## What It Does\n\nSay **\"review my app\"** and Reviewer spawns as an agent that inspects your Xcode project the same way an Apple reviewer would — checking source code, entitlements, privacy manifests, metadata, and configuration against 100+ App Store Review Guidelines.\n\nIt finds the violations, cites the exact guideline, points to the offending file, and tells you how to fix it. Then it offers to fix what it can automatically.\n\nNo external CLI tools required.\n\n## Install\n\n### Claude Code (recommended)\n\nOne command from your Xcode project directory:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/blitzdotdev/app-store-review-agent/main/install.sh | bash\n```\n\nThis clones the repo into `.claude/app-store-review-agent/` and symlinks the agent into `.claude/agents/` where Claude Code can find it.\n\nRestart Claude Code, then say:\n\n```\nreview my app\n```\n\nVerify it's installed with `/agents` — you should see `reviewer` listed.\n\n### Codex / OpenCode / Other Agents\n\nClone or submodule into your project root:\n\n```bash\ngit submodule add https://github.com/blitzdotdev/app-store-review-agent.git reviewer\n```\n\nThen point your agent at the `SKILL.md` (included for compatibility):\n\n```\n@reviewer/SKILL.md review my app\n```\n\nOr copy the `SKILL.md` contents into your agent's system prompt / instructions file.\n\n### Manual (any agent)\n\nJust paste this into your conversation:\n\n```\nRead the file reviewer/SKILL.md and follow its instructions to review my app.\n```\n\n## What Gets Installed\n\n```\nyour-project/\n└── .claude/\n    ├── agents/\n    │   └── reviewer.md → ../app-store-review-agent/agents/reviewer.md  (symlink)\n    └── app-store-review-agent/          (cloned repo)\n        ├── agents/\n        │   └── reviewer.md             # Agent definition (spawns as subagent)\n        ├── references/\n        │   ├── guidelines/             # 100+ Apple guidelines + 10 app-type checklists\n        │   └── rules/                  # Rejection pattern detection rules\n        ├── install.sh                  # 1-click installer\n        ├── SKILL.md                    # Codex/OpenCode compatibility\n        └── README.md\n```\n\n## What It Checks\n\n### Metadata\n\n| Rule | Guideline | What It Catches |\n|------|-----------|----------------|\n| [competitor_terms](./references/rules/metadata/competitor_terms.md) | 2.3.1 | Android, Google Play, and other competitor brands |\n| [apple_trademark](./references/rules/metadata/apple_trademark.md) | 5.2.5 | Apple device images in icon, Apple trademark misuse |\n| [china_storefront](./references/rules/metadata/china_storefront.md) | 5 | OpenAI/ChatGPT/Gemini references (China) |\n| [accurate_metadata](./references/rules/metadata/accurate_metadata.md) | 2.3.4 | Device frames in app preview videos |\n| [subscription_metadata](./references/rules/metadata/subscription_metadata.md) | 3.1.2 | Missing ToS/EULA and Privacy Policy links |\n\n### Subscriptions\n\n| Rule | Guideline | What It Catches |\n|------|-----------|----------------|\n| [missing_tos_pp](./references/rules/subscription/missing_tos_pp.md) | 3.1.2 | No Terms or Privacy Policy in app/metadata |\n| [misleading_pricing](./references/rules/subscription/misleading_pricing.md) | 3.1.2 | Monthly price more prominent than billed amount |\n\n### Privacy\n\n| Rule | Guideline | What It Catches |\n|------|-----------|----------------|\n| [unnecessary_data](./references/rules/privacy/unnecessary_data.md) | 5.1.1 | Requiring irrelevant personal data |\n| [privacy_manifest](./references/rules/privacy/privacy_manifest.md) | 5.1.1 | Missing `PrivacyInfo.xcprivacy` |\n\n### Design\n\n| Rule | Guideline | What It Catches |\n|------|-----------|----------------|\n| [sign_in_with_apple](./references/rules/design/sign_in_with_apple.md) | 4.0 | Asking name/email after SIWA |\n| [minimum_functionality](./references/rules/design/minimum_functionality.md) | 4.2 | WebView wrappers, apps with \u003c 3 screens, no unique value |\n\n### Entitlements\n\n| Rule | Guideline | What It Catches |\n|------|-----------|----------------|\n| [unused_entitlements](./references/rules/entitlements/unused_entitlements.md) | 2.4.5(i) | Unused entitlements in Xcode project |\n\n## Guideline Reference\n\nComplete index of all 100+ Apple Review Guidelines and 10 app-type specific checklists in [`references/guidelines/`](./references/guidelines/).\n\n## Adding New Rules\n\nCreate a `.md` file in the appropriate `references/rules/` subdirectory:\n\n```markdown\n# Rule: [Short Title]\n- **Guideline**: [Apple Guideline Number]\n- **Severity**: REJECTION | WARNING\n- **Category**: metadata | subscription | privacy | design | entitlements\n\n## What to Check\n## How to Detect\n## Resolution\n## Example Rejection\n```\n\n## License\n\nMIT — Based on [app-store-preflight-skills](https://github.com/truongduy2611/app-store-preflight-skills) by truongduy2611.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblitzdotdev%2Fapp-store-review-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblitzdotdev%2Fapp-store-review-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblitzdotdev%2Fapp-store-review-agent/lists"}