Reference
Troubleshootingการแก้ปัญหา
Quick answers to the most common Cosmos issues: macOS install verification warnings, a slow first launch, an AI tool that can't see the cosmos MCP server, Plus sign-in, and where your data lives.คำตอบแบบรวบรัดสำหรับปัญหาที่พบบ่อยที่สุดของ Cosmos: คำเตือนการตรวจสอบแอปบน macOS, การเปิดครั้งแรกที่ช้า, AI tool ที่มองไม่เห็น cosmos MCP server, การเข้าสู่ระบบ Plus และตำแหน่งที่เก็บข้อมูลของคุณ
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)
Alpha builds may not be Apple-notarized yet. First, download the newest .dmg, move Cosmos.app into /Applications, right-click the app, choose Open, and confirm. If that still fails, clear the quarantine flag and reopen:
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
Public notarized builds should open without this fallback. See Install Cosmos on macOS for the normal 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.
Plus says Not signed in
Paid workflow gates need a Cosmos account. Open Settings → About → Sign up / Log in. The launch offer starts with 30 days free, then $6 for the first paid month, then $12/month. More detail in Cosmos Plus features.
Where does my data live, and can I delete it?
- Local:
data/brain_v2/brain.db, stored next to the app. - Hosted backup/sync: roadmap services, not required for current Free or Plus usage.
To delete local data, remove your local brain by deleting the data/ folder. For account, waitlist, or billing-related deletion, contact support.
Still stuck? Reach the team via Support & contact.
คำตอบแบบรวบรัดสำหรับปัญหาที่พบบ่อยที่สุดของ Cosmos บน macOS แต่ละคำถามด้านล่างเขียนในแบบที่คุณน่าจะใช้ค้นหา พร้อมวิธีแก้ที่ตรงจุดอยู่ด้านล่าง
macOS แจ้งว่า Cosmos can't be opened (Apple ตรวจสอบหาซอฟต์แวร์ที่เป็นอันตรายไม่ได้)
Alpha build อาจยังไม่ได้ผ่าน Apple notarization ให้ดาวน์โหลด .dmg ล่าสุด ย้าย Cosmos.app เข้า /Applications แล้วคลิกขวาที่แอป เลือก Open และยืนยัน ถ้ายังไม่ผ่าน ให้ล้าง flag quarantine แล้วเปิดใหม่อีกครั้ง:
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
บิลด์ public ที่ notarized แล้วควรเปิดได้โดยไม่ต้องใช้ fallback นี้ ดูขั้นตอนการติดตั้งแบบปกติได้ที่ 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
Plus แจ้งว่า Not signed in
Paid workflow gates ต้องใช้บัญชี Cosmos ให้เปิด Settings → About → Sign up / Log in โปรเปิดตัวเริ่มจากใช้ฟรี 30 วัน ต่อด้วย $6 สำหรับเดือนแรกที่จ่าย แล้วเป็น $12/เดือน ดูรายละเอียดเพิ่มเติมได้ที่ Cosmos Plus features
ข้อมูลของฉันเก็บอยู่ที่ไหน และลบได้ไหม?
- ในเครื่อง:
data/brain_v2/brain.dbเก็บอยู่ข้าง ๆ ตัวแอป - Hosted backup/sync: เป็น roadmap services ยังไม่จำเป็นสำหรับการใช้งาน Free หรือ Plus วันนี้
วิธีลบข้อมูล local: ลบ brain ในเครื่องด้วยการลบโฟลเดอร์ data/ ส่วนข้อมูลบัญชี, waitlist หรือ billing ให้ติดต่อ support
ยังติดปัญหาอยู่? ติดต่อทีมงานได้ที่ Support & contact
- Atitechs EngineeringMaintainer