Skip to content

docs: note macOS/Xcode-only build for cloud agents - #4

Merged
J2TeamNNL merged 1 commit into
feat/agent-workspacefrom
cursor/document-cloud-env-limitations-acdf
Aug 26, 2026
Merged

docs: note macOS/Xcode-only build for cloud agents#4
J2TeamNNL merged 1 commit into
feat/agent-workspacefrom
cursor/document-cloud-env-limitations-acdf

Conversation

@J2TeamNNL

Copy link
Copy Markdown
Owner

Summary

Attempted to set up the development environment for a Cloud Agent (Linux VM). TablePro is a native macOS/iOS app built with Xcode + XcodeGen, using AppKit, SwiftUI, and CloudKit. It cannot be built, tested, or run on Linux, and Xcode/AppKit cannot be installed on Linux.

This PR adds an AGENTS.md with a ## Cursor Cloud specific instructions section so future cloud agents immediately know the environment constraint and where the real build/test/lint commands live (README.md, CLAUDE.md).

What was verified

  • VM is Ubuntu 24.04.4 LTS (x86_64).
  • No Apple toolchain present or installable: xcodebuild, swift, swiftc, xcrun, xcodegen, swiftlint, swiftformat all missing.
  • Packages/TableProCore declares only .macOS(.v14) / .iOS(.v17) and its core targets import AppKit/CloudKit, so swift build/swift test on Linux is not viable.
  • Libs/ / Libs/ios/ are prebuilt macOS/iOS binaries, unusable without Xcode.

Not done (and why)

  • No SetupVmEnvironment update script: there is no valid Linux dependency-install/refresh step for a macOS-only Xcode project.
  • No app build/run/test artifacts: the application requires macOS + Xcode, which is unavailable on this VM.
Open in Web Open in Cursor 

Co-authored-by: Nguyễn Nam Long <J2TeamNNL@users.noreply.github.com>
@J2TeamNNL
J2TeamNNL marked this pull request as ready for review August 25, 2026 07:21
@J2TeamNNL
J2TeamNNL merged commit 6e548a0 into feat/agent-workspace Aug 26, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants