Reference
Troubleshootingการแก้ปัญหา
Quick answers to the most common Cosmos issues: the macOS gatekeeper warning on ad-hoc-signed builds, a slow first launch, an AI tool that can't see the cosmos MCP server, cloud-backup sign-in, and where your data lives.คำตอบแบบรวบรัดสำหรับปัญหาที่พบบ่อยที่สุดของ Cosmos: คำเตือน gatekeeper บน macOS สำหรับ build ที่เซ็นแบบ ad-hoc, การเปิดครั้งแรกที่ช้า, AI tool ที่มองไม่เห็น cosmos MCP server, การเข้าสู่ระบบสำหรับ cloud backup และตำแหน่งที่เก็บข้อมูลของคุณ
Quick answers to the most common Cosmos issues on macOS. Each question below is phrased the way you'd search for it, with the exact fix underneath.
macOS says Cosmos can't be opened (Apple cannot check it for malicious software)
This is expected on ad-hoc-signed builds. Clear the quarantine flag and reopen:
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
A notarised release lands once we have the Apple Developer certificate, after which this warning disappears. See Install Cosmos on macOS for the full install flow.
First launch hangs for ~10 seconds
That pause is normal on the first run. The bundled Python sidecar unpacks into /tmp and verifies its assets; later launches are instant. If it stays hung for longer than 30 seconds, check the sidecar log or the advanced settings:
tail -n 100 ~/Library/Logs/aibran-sidecar.log
You can also open Settings → Advanced for sidecar status.
Claude Code doesn't see the cosmos MCP
Restart the tool after the wizard installs the server — most AI tools only read their MCP config at startup. Then verify the connection:
/mcp
The server is named cosmos (or ai-bran on older configs). If it still doesn't appear, re-run the wizard from Integrations → AI Coding Tools.
Cloud backup says Not signed in
Pro features need a Cosmos account. Open Settings → About → Sign up / Log in. The 30-day trial includes Pro, with no card required. More detail in Pro features & cloud backup.
Where does my data live, and can I delete it?
- Local:
data/brain_v2/brain.db, stored next to the app. - Cloud (Pro): the Supabase Storage bucket
cosmos-backups/<your_user_id>/, reachable only by you via row-level security (RLS).
To delete: remove cloud backups in Settings → Files & Backup, and delete your local brain by removing the data/ folder.
Still stuck? Reach the team via Support & contact.
คำตอบแบบรวบรัดสำหรับปัญหาที่พบบ่อยที่สุดของ Cosmos บน macOS แต่ละคำถามด้านล่างเขียนในแบบที่คุณน่าจะใช้ค้นหา พร้อมวิธีแก้ที่ตรงจุดอยู่ด้านล่าง
macOS แจ้งว่า Cosmos can't be opened (Apple ตรวจสอบหาซอฟต์แวร์ที่เป็นอันตรายไม่ได้)
อาการนี้เป็นเรื่องปกติสำหรับ build ที่เซ็นแบบ ad-hoc ให้ล้าง flag quarantine แล้วเปิดใหม่อีกครั้ง:
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
เราจะปล่อยรุ่นที่ผ่าน notarised ทันทีที่ได้ใบรับรอง Apple Developer หลังจากนั้นคำเตือนนี้จะหายไป ดูขั้นตอนการติดตั้งแบบเต็มได้ที่ Install Cosmos on macOS
การเปิดครั้งแรกค้างราว ๆ 10 วินาที
การหยุดชั่วครู่นี้เป็นเรื่องปกติในการรันครั้งแรก Python sidecar ที่มาพร้อมแอปจะแตกไฟล์ลงใน /tmp และตรวจสอบ asset ของตัวเอง การเปิดครั้งต่อ ๆ ไปจะรวดเร็วทันที หากค้างนานเกิน 30 วินาที ให้ตรวจสอบ log ของ sidecar หรือดูที่ advanced settings:
tail -n 100 ~/Library/Logs/aibran-sidecar.log
คุณยังเปิด Settings → Advanced เพื่อดูสถานะของ sidecar ได้ด้วย
Claude Code มองไม่เห็น cosmos MCP
ให้รีสตาร์ท tool หลังจากที่ wizard ติดตั้ง server เสร็จ — AI tool ส่วนใหญ่จะอ่านค่า config ของ MCP เฉพาะตอนเริ่มทำงานเท่านั้น จากนั้นตรวจสอบการเชื่อมต่อ:
/mcp
server มีชื่อว่า cosmos (หรือ ai-bran ในไฟล์ config รุ่นเก่า) หากยังไม่ปรากฏ ให้รัน wizard อีกครั้งจาก Integrations → AI Coding Tools
Cloud backup แจ้งว่า Not signed in
ฟีเจอร์ Pro ต้องใช้บัญชี Cosmos ให้เปิด Settings → About → Sign up / Log in ช่วงทดลองใช้ 30 วันรวมฟีเจอร์ Pro ไว้แล้วโดยไม่ต้องใช้บัตร ดูรายละเอียดเพิ่มเติมได้ที่ Pro features & cloud backup
ข้อมูลของฉันเก็บอยู่ที่ไหน และลบได้ไหม?
- ในเครื่อง:
data/brain_v2/brain.dbเก็บอยู่ข้าง ๆ ตัวแอป - บน Cloud (Pro): Supabase Storage bucket ที่
cosmos-backups/<your_user_id>/ซึ่งเข้าถึงได้เฉพาะคุณคนเดียวผ่าน row-level security (RLS)
วิธีลบ: ลบ cloud backup ได้ที่ Settings → Files & Backup และลบ brain ในเครื่องด้วยการลบโฟลเดอร์ data/
ยังติดปัญหาอยู่? ติดต่อทีมงานได้ที่ Support & contact
- Atitechs EngineeringMaintainer