Add AGENTS.md with cloud development environment instructions

[green2grey]

Summary

Adds AGENTS.md with Cursor Cloud-specific development instructions for this macOS-only Swift project.

What's included

• Documents the macOS-only build limitation (Cocoa/AppKit frameworks unavailable on Linux)
• Lists available tooling that works cross-platform on Cloud Agent VMs:
  • swift package resolve for dependency management
  • swift package dump-package for manifest validation
  • swiftlint lint Sources/ for code linting
• Notes project structure, dependencies, and build instructions
• Provides guidance for what agents can and cannot do on Linux

Context

DockPin is a native macOS menu bar utility that uses Cocoa, AppKit, CoreGraphics, and ApplicationServices — none of which exist on Linux. The Cloud Agent VM runs Ubuntu 24.04, so swift build will always fail with error: no such module 'Cocoa'. However, dependency resolution, package manifest validation, and SwiftLint all work correctly on Linux.

Environment verification

Check	Result
swift package resolve	Sparkle 2.9.2 fetched successfully
swift package dump-package	Package manifest valid
swiftlint lint Sources/	47 pre-existing violations found across 11 files (lint runs successfully)
swift build	Expected failure: no such module 'Cocoa' (macOS-only)

swiftlint_output.log

_{To show artifacts inline, enable in settings.}

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b3af4478-8c63-4536-9d76-038bfd302401

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/dev-environment-setup-6732

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}