docs: Cursor Cloud Linux development environment guide - #39
Conversation
Document SwiftLint/Ollama workflows on Linux VMs, macOS-only xcodebuild requirements, and Ollama tmux startup for cloud agents. Co-authored-by: Tim Champ <bisonbet@users.noreply.github.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 781a3010bc
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| SESSION_NAME="ollama-server" | ||
| tmux -f /exec-daemon/tmux.portal.conf has-session -t "=$SESSION_NAME" 2>/dev/null \ | ||
| || tmux -f /exec-daemon/tmux.portal.conf new-session -d -s "$SESSION_NAME" -- "${SHELL:-bash}" -l | ||
| tmux -f /exec-daemon/tmux.portal.conf send-keys -t "$SESSION_NAME:0.0" 'ollama serve' C-m |
There was a problem hiding this comment.
Bind Ollama to an external interface
When following the later Mac + Linux VM workflow and pointing the app at http://<cloud-vm-host>:11434, this ollama serve command leaves Ollama listening only on loopback by default. The official Ollama FAQ states that Ollama binds 127.0.0.1:11434 by default and needs OLLAMA_HOST to change the bind address, so the VM-local smoke tests pass while the Mac/device cannot connect to the advertised host URL.
Useful? React with 👍 / 👎.
Summary
Documents how to develop BisonHealth AI on Cursor Cloud Linux VMs, where the iOS app cannot be built or run. Covers SwiftLint static analysis, optional Ollama backend smoke tests, and macOS-only
xcodebuildrequirements.Environment verified on Linux VM
0.57.0— lintsHealthApp/Swift sources (5092 existing style warnings; no new code changes)127.0.0.1:11434—/api/tagsand/api/chathello-world successful (tinyllama)6.0.3toolchain installed at/opt/swiftVM startup
Update script is a no-op (
true) — no root lockfiles in this repo; SwiftPM resolves on Mac via Xcode.Privacy
Documentation only; no PHI or secrets.