Getting started

Install Cosmos on macOSติดตั้ง Cosmos บน macOS

Join the waitlist for a download link, drag Cosmos.app into /Applications, then run a one-line xattr command to clear macOS quarantine and launch the app.ลงทะเบียน waitlist เพื่อรับลิงก์ดาวน์โหลด ลาก Cosmos.app เข้าไปใน /Applications แล้วรันคำสั่ง xattr บรรทัดเดียวเพื่อล้าง quarantine ของ macOS และเปิดแอป

Installing Cosmos on macOS takes three steps: get your download link, drag the app into /Applications, then strip the macOS quarantine flag so it opens. Because current builds are ad-hoc signed, you run one extra command today — it goes away in the public release.

Before you start

Apple Silicon (M-series) is the primary, fully supported target. Intel Macs and other operating systems are in development.
You need a download link, which is delivered by email after you join the waitlist.

1. Get a download link

2. Install the app

Open the downloaded .dmg and drag Cosmos.app into your /Applications folder, just like any other Mac app.

3. Strip the quarantine flag and open

macOS quarantines apps downloaded outside the App Store. Clear the flag, then launch the app:

bash

xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app

After the first successful open, you launch Cosmos normally from Launchpad or the Applications folder.

Why is this manual step needed?

Current builds are ad-hoc signed. A notarised release is pending an Apple Developer certificate. Once notarised, macOS will open Cosmos without the xattr step — this manual step goes away in the public release.

Which Macs are supported?

Apple Silicon (M-series) is the primary, fully supported target. Intel Macs and other operating systems are in active development.

Is the xattr command safe?

Yes. xattr -cr recursively clears extended attributes — including the quarantine flag — on the app bundle you just installed. It does not modify the app's code or your data.

macOS still says Cosmos can't be opened — what now?

That warning is expected on ad-hoc-signed builds. Re-run xattr -cr /Applications/Cosmos.app and reopen. See Troubleshooting for more.

การติดตั้ง Cosmos บน macOS มีสามขั้นตอน: รับลิงก์ดาวน์โหลด ลากแอปเข้าไปใน /Applications แล้วลบ quarantine flag ของ macOS ออกเพื่อให้เปิดได้ เนื่องจากบิลด์ปัจจุบันเป็นแบบ ad-hoc signed คุณจึงต้องรันคำสั่งเพิ่มอีกหนึ่งคำสั่งในตอนนี้ ซึ่งจะหายไปเมื่อปล่อยเวอร์ชันสาธารณะ

ก่อนเริ่ม

Apple Silicon (ชิปตระกูล M) เป็นเป้าหมายหลักที่รองรับเต็มรูปแบบ ส่วน Mac ที่ใช้ Intel และระบบปฏิบัติการอื่น ๆ ยังอยู่ระหว่างการพัฒนา
คุณต้องมีลิงก์ดาวน์โหลด ซึ่งจะถูกส่งทางอีเมลหลังจากลงทะเบียน waitlist

1. รับลิงก์ดาวน์โหลด

ลงทะเบียนใน waitlist เพื่อรับลิงก์ดาวน์โหลดไฟล์ .dmg ทางอีเมล ลิงก์นี้จะชี้ไปยังบิลด์ที่เซ็นล่าสุด

2. ติดตั้งแอป

เปิดไฟล์ .dmg ที่ดาวน์โหลดมา แล้วลาก Cosmos.app เข้าไปในโฟลเดอร์ /Applications เหมือนกับแอป Mac ทั่วไป

3. ลบ quarantine flag แล้วเปิดใช้งาน

macOS จะ quarantine แอปที่ดาวน์โหลดจากนอก App Store ให้ล้าง flag นี้ออกก่อน แล้วจึงเปิดแอป: