Tools
I build open-source tools that help iOS teams find release and UI-automation problems before they become App Review rejections or flaky pull requests.
The projects form one iOS Release Quality Toolkit. Each tool is local-first, inspectable, and designed to give both developers and coding agents concrete evidence instead of vague recommendations.
Install the agent toolkit
View the unified Codex plugin and releases
The release-pinned skills-only plugin gives Codex all three workflows behind natural problem-based triggers:
codex plugin marketplace add Kofiloski/ios-release-quality-toolkit --ref v0.1.0
codex plugin add ios-release-quality-toolkit@kofiloski-ios-tools
The individual repositories below remain the canonical sources for their scanners, GitHub Action, examples, and issue trackers. Their agent skills also follow the open skills/<name>/SKILL.md convention for compatible installers.
App Store Review Risk
Catch likely App Store rejection risks in an Xcode repository or pull-request diff before Apple sees the build. The deterministic scanner reports file-level evidence for privacy manifests, permission strings, entitlements, StoreKit, notarization, and other Apple-platform release risks.
Use it when someone asks:
- "Could Apple reject this build?"
- "Review this iOS pull request for App Store risk."
- "Check our privacy manifest, permission strings, entitlements, or StoreKit setup."
pipx run --spec git+https://github.com/Kofiloski/app-store-review-risk.git@v0.3.0 app-store-review-risk .
iOS UI Testability Contract
Diagnose XCUITest element not found, wrong-element-type, accessibility-identifier collision, and nondeterministic launch-route failures in SwiftUI and UIKit. The scanner and agent workflow identify the smallest app-side contract fix and verify a focused replay.
Use it when a visible control cannot be found, an identifier resolves to a container instead of its child control, or a UI test cannot reach a screen deterministically.
pipx run --spec git+https://github.com/Kofiloski/ios-ui-testability-contract-skill.git@v0.4.0 ios-ui-testability ids .
iOS AI UI Check
Add AI-planned, evidence-rich iOS Simulator checks to GitHub pull requests without replacing app-owned XCUITest logic. The reusable action produces focused test results, screenshots, video, a machine-readable artifact manifest, and a pull-request summary.
Use it when a team wants a plain-English UI goal turned into a reproducible Simulator check with inspectable evidence.
jobs:
ui-check:
uses: Kofiloski/ios-ai-ui-check/.github/workflows/run.yml@v0.3.0
with:
provided-scenario-path: .github/ai-ui/verify-primary-flow.json
How the tools fit together
- App Store Review Risk checks whether the repository and release configuration look ready for Apple review.
- iOS UI Testability Contract repairs the accessibility and deterministic-launch surface that UI automation depends on.
- iOS AI UI Check runs the app-owned automation contract in CI and preserves evidence for developers and agents.
The three focused projects and unified plugin are maintained by Kristijan Kofiloski, an iOS engineer and the founder of iOSKonf. They are open source under the MIT license. The tools do not claim to guarantee App Review approval or replace deliberate XCTest assertions.