Skip to content

Set up Cursor Cloud (Linux) dev environment#93

Closed
kyleve wants to merge 1 commit into
mainfrom
cursor/set-up-dev-environment-cfd8
Closed

Set up Cursor Cloud (Linux) dev environment#93
kyleve wants to merge 1 commit into
mainfrom
cursor/set-up-dev-environment-cfd8

Conversation

@kyleve

@kyleve kyleve commented Jul 16, 2026

Copy link
Copy Markdown
Owner

What

Sets up the Cursor Cloud (Linux) development environment for this macOS-first iOS repo, and corrects the now-outdated ## Cursor Cloud specific instructions in AGENTS.md.

Environment set up (persisted in the VM snapshot)

  • mise (in ~/.local/bin, activated in ~/.bashrc)
  • Pinned tools from .mise.toml via mise install — SwiftFormat 0.60.1 and Tuist 4.200.5
  • Ruby (required by ./sync-agents)
  • Git hooks path pointed at .githooks

Startup update script

"$HOME/.local/bin/mise" trust
"$HOME/.local/bin/mise" install
./sync-agents --install

Key finding — AGENTS.md was outdated

The previous notes claimed mise install / mise install tuist fail on Linux (unsupported env: linux/amd64) and that ./swiftformat fails. That is no longer true: Tuist now ships a Linux binary, so mise install, tuist version, and ./swiftformat --lint all work. However, iOS project generation / build / test / running the Where app still require macOS + Xcode (no xcodebuild/xcrun on Linux), and the Linux Tuist generate is a server-side command group (so ./ide fails at the tuist generate step). AGENTS.md is updated to reflect this accurately.

Verified on Linux

  • mise exec swiftformat -- swiftformat --lint . — CI format job equivalent, 0/475 files require formatting
  • ./swiftformat --lint
  • ./sync-agents and ./sync-agents --install
  • ⚠️ mise exec -- tuist test …, ./ide, iOS build/run — macOS-only, cannot run on the Linux VM

dev_env_setup_verification.log

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

The Linux Tuist binary now installs and runs (mise install / tuist version
work), so the prior note that 'mise install tuist fails: unsupported env'
and that ./swiftformat fails is outdated. Correct the Cursor Cloud section:
- ./swiftformat --lint and mise install work on Linux
- iOS project generation/build/test/run still require macOS + Xcode
  (no xcodebuild/xcrun); ./ide fails at the 'tuist generate' step because
  the Linux binary's generate is a server-side command group.
@kyleve kyleve closed this Jul 16, 2026
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