From 12c2acf6a205ec091f25f79bb6267a6f3b56dc9d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 21 Jul 2026 01:29:49 +0000 Subject: [PATCH] Document iOS platform requirement for Cloud Agent env setup Co-authored-by: Aaditya Jain --- AGENTS.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..7a4b06b --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,33 @@ +# CheckList - iOS App + +## Cursor Cloud specific instructions + +### Platform requirement (important) +This is a **native iOS app**. It **cannot be built, run, linted, or tested on the Linux Cloud Agent VM**. Building and running require **macOS with Xcode**. This is a platform incompatibility, not a missing dependency — no `apt`/`pip`/toolchain install on Linux can fix it: +- The sources import `UIKit` and `CoreData` (`CheckList/AppDelegate.swift`, `CheckList/ViewController.swift`), which are Apple-proprietary frameworks not available on Linux. +- The Xcode project targets the iOS SDK (`SDKROOT = iphoneos`, `IPHONEOS_DEPLOYMENT_TARGET = 10.3`, `product-type = com.apple.product-type.application` in `CheckList.xcodeproj/project.pbxproj`). +- Even a Swift-for-Linux toolchain would not help (UIKit/CoreData are absent), and the Swift download hosts (`download.swift.org`, `archive.swiftlang.xyz`) are blocked by Cloud Agent egress anyway. + +### Project overview +- **Language:** Swift 3.0 (`SWIFT_VERSION = 3.0`, created with Xcode 8.3.2) +- **Target:** iOS 10.3, iPhone + iPad (`TARGETED_DEVICE_FAMILY = 1,2`) +- **UI:** UIKit with Interface Builder storyboards (`CheckList/Base.lproj/Main.storyboard`, `LaunchScreen.storyboard`) +- **Data:** Core Data (`NSPersistentContainer` in `AppDelegate.swift`; model at `CheckList/CheckList.xcdatamodeld` — currently defines no entities) +- **Dependencies:** None — no CocoaPods, Carthage, or Swift Package Manager files, and no vendored frameworks +- **Tests:** No test target exists in the project + +### What can be done on the Linux VM +- Read/edit Swift sources (`AppDelegate.swift`, `ViewController.swift`) and storyboard XML. +- Inspect/validate the Xcode project structure (`CheckList.xcodeproj/project.pbxproj`). +- You cannot compile, run, lint, or test — those steps require macOS + Xcode. + +### Build & run (macOS + Xcode only) +``` +open CheckList.xcodeproj +# In Xcode: select an iOS Simulator (e.g. iPhone), then Cmd+R to build and run. +# Xcode will offer to migrate the Swift 3.0 syntax to a modern Swift version on first open. +``` + +### Caveats +- The app is a skeleton: `ViewController.swift` is essentially empty and the Core Data model has no entities, so there is no meaningful runtime behavior to exercise yet even on macOS. +- Opening in a modern Xcode requires a Swift 3 → current migration.