Skip to content

Document iOS platform requirement for Cloud Agent env setup #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
aj327 wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

Document iOS platform requirement for Cloud Agent env setup #7

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.