Get Cosmos running on macOS. ติดตั้ง Cosmos บน macOS

Cosmos ships as a private, on-device memory layer that is easy to install in a single step with zero complex setup. Currently optimized for modern macOS hardware, with versions for other environments actively in development. Cosmos เป็น memory layer ส่วนตัวที่รันบนเครื่องคุณ ติดตั้งง่ายในขั้นตอนเดียว ไม่ต้อง setup อะไรซับซ้อน ตอนนี้รองรับ Mac รุ่นใหม่ (Apple Silicon) เป็นหลัก ส่วนเวอร์ชันสำหรับ OS อื่นกำลังพัฒนาอยู่

หมายเหตุ: คำสั่ง terminal และค่า config ต่าง ๆ คงไว้เป็นภาษาอังกฤษ เพื่อให้ copy ไปรันได้ตรง ๆ ไม่ผิดเพี้ยน

1. Sign up on the waitlist — we'll email you a direct download link. ลงทะเบียน waitlist — เราจะส่งลิงก์ดาวน์โหลดให้ทางอีเมล
2. Open the .dmg and drag Cosmos.app into /Applications. เปิดไฟล์ .dmg แล้วลาก Cosmos.app ลง /Applications
3. Strip Apple's quarantine flag — current builds are ad-hoc signed (notarised release pending Apple Developer cert): ปลด quarantine flag ของ Apple — build ตอนนี้เป็นแบบ ad-hoc signed (ยังรอ Apple Developer cert ถึงจะ notarise ได้):
   Terminal

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

This security step is a temporary requirement for our early private release and will be completely automated in our upcoming public versions.

ขั้นตอนนี้จำเป็นเฉพาะช่วง private release ตอนนี้เท่านั้น เวอร์ชัน public จะทำให้อัตโนมัติทั้งหมด

Point Cosmos at your first folder. ชี้ Cosmos ไปที่โฟลเดอร์แรกของคุณ

The first time you open Cosmos it asks for one thing: a folder to remember. Point it at a code repo, a notes vault, or any directory of files — Cosmos indexes the symbols and text on-device so your AI can recall them later. Indexing runs in the background and stays incremental as files change.

เปิด Cosmos ครั้งแรก มันจะขอแค่อย่างเดียว: โฟลเดอร์ที่อยากให้จำ จะเป็น code repo, คลังโน้ต หรือโฟลเดอร์ไฟล์อะไรก็ได้ — Cosmos จะ index ทั้ง symbol และ text ไว้ในเครื่อง ให้ AI ดึงไปใช้ทีหลัง การ index รันอยู่เบื้องหลังและอัปเดตเฉพาะส่วนที่เปลี่ยน

1. In the left folder tree, click + Add folder (or drag a folder onto the window). ที่ folder tree ด้านซ้าย คลิก + เพิ่มโฟลเดอร์ (หรือลากโฟลเดอร์มาวางบนหน้าต่างก็ได้)
2. Pick a repo you want your AI to remember. Cosmos starts indexing it immediately. เลือก repo ที่อยากให้ AI จำ Cosmos จะเริ่ม index ทันที
3. Wait for the indexer to finish (a progress badge shows in the sidebar). Large repos index in the background — you can keep working. รอให้ indexer ทำเสร็จ (มี badge บอกความคืบหน้าที่ sidebar) repo ใหญ่จะ index อยู่เบื้องหลัง — ใช้งานต่อได้เลย
4. That's it — your AI tool can now recall this folder's code and past lessons through MCP. เท่านี้แหละ — AI tool ของคุณดึงโค้ดและ lesson เก่า ๆ ของโฟลเดอร์นี้ผ่าน MCP ได้แล้ว

You can add more folders any time. Each stays scoped on-device — nothing is uploaded.

เพิ่มโฟลเดอร์เพิ่มได้ตลอด แต่ละโฟลเดอร์แยก scope กันในเครื่อง ไม่มีอะไรอัปโหลดออกไป

Cosmos as memory infrastructure. Cosmos ในฐานะ memory infrastructure บนเครื่องคุณ

The onboarding wizard installs everything automatically. If you skipped it, re-run from Integrations → AI Coding Tools, or wire it up by hand:

wizard ตอน onboarding จะติดตั้งให้อัตโนมัติทั้งหมด ถ้าข้ามไป กดรันใหม่ได้ที่ Integrations → AI Coding Tools หรือจะตั้งเองก็ได้:

Claude Code (.mcp.json in any project) Claude Code (.mcp.json ในโปรเจกต์ไหนก็ได้)

{
  "mcpServers": {
    "cosmos": {
      "command": "/Applications/Cosmos.app/Contents/Resources/start-mcp.sh"
    }
  }
}

Cursor / Cline / Windsurf

Each tool has its own MCP config file. The wizard knows the right path for each and writes the same launcher entry there. If you want to do it manually, see the tool's own MCP docs and point at start-mcp.sh.

แต่ละ tool มีไฟล์ config MCP ของตัวเอง wizard รู้ path ที่ถูกต้องของแต่ละตัวและเขียน entry เดียวกันให้เอง ถ้าอยากตั้งเอง ดู MCP docs ของ tool นั้นแล้วชี้ไปที่ start-mcp.sh

Tools you get tool ที่คุณจะได้ใช้

• brain_search — BM25 + tokenizer over the whole brain ค้นทั้ง brain ด้วย BM25 + tokenizer
• find_relevant_code — symptom + past-lesson recall in one round-trip จับอาการบั๊ก + ดึง lesson เก่าที่ตรงกัน ในการเรียกครั้งเดียว
• code_skeleton / code_get_symbol / code_callers / code_callees / code_uses
• code_explain_project / code_diff / code_context_bundle
• brain_remember / brain_get / brain_aggregate / brain_session_context / brain_pattern_recall
• code_remember_error / code_list_errors — the moat คลัง bug + วิธีแก้ที่สะสมไว้ — จุดที่ลอกเลียนยากสุด

Capture from your phone. capture จากมือถือได้ทุกที่

Cosmos's Telegram integration uses Gemini Function Calling so the bot can search your brain, save new memories, set timed reminders, and append to existing notes.

Telegram bot ของ Cosmos ใช้ Gemini Function Calling ทำให้ bot ค้น brain ของคุณ, บันทึก memory ใหม่, ตั้ง reminder ตามเวลา และเขียนต่อในโน้ตเดิมได้ — สั่งด้วยภาษาธรรมชาติล้วน ๆ

1. Open @BotFather in Telegram. Run /newbot and copy the token. เปิด @BotFather ใน Telegram รัน /newbot แล้ว copy token มา
2. Get a Google Gemini API key from aistudio.google.com (free tier covers most personal use). ขอ Google Gemini API key ที่ aistudio.google.com (free tier ก็พอสำหรับใช้ส่วนตัว)
3. In Cosmos: Integrations → Telegram → paste token + key → Start. ใน Cosmos: Integrations → Telegram → วาง token + key → Start
4. Open your bot in Telegram and send any message. The chat_id is captured automatically. เปิดแชตกับ bot ของคุณใน Telegram แล้วส่งข้อความอะไรก็ได้ ระบบจะเก็บ chat_id ให้อัตโนมัติ

Things you can say ตัวอย่างที่พิมพ์สั่งได้

• "remind me in 30 min — take medicine" — sets a reminder, fires Telegram + macOS notification
• "อีก 30 นาทีเตือนกินยาด้วย" — ตั้ง reminder แล้วเด้งทั้ง Telegram + macOS notification
• "tomorrow at 9 — call mom" — natural-language scheduling (Thai + English supported)
• "พรุ่งนี้ 9 โมงเตือนโทรหาแม่" — เข้าใจภาษาธรรมชาติเพื่อตั้งตารางเวลา (รองรับทั้งไทยและอังกฤษ)
• "What did I trade last week?" — bot calls brain_aggregate
• "Save: meeting on Friday at 3" — saves to /Calendar

One Cosmos, many scoped sub-brains. Cosmos ตัวเดียว แบ่งเป็น sub-brain แยก scope ได้หลายตัว

Building a research agent + a coder + a reviewer with OpenCode, Cline, or Cursor? Each agent gets its own /Agents/<name> folder seeded with prompt.md, context.md, and rules.md. The external AI connects MCP scoped to that folder — agents never poison each other's memory.

กำลังสร้าง research agent + coder + reviewer ด้วย OpenCode, Cline หรือ Cursor อยู่? แต่ละ agent จะได้โฟลเดอร์ /Agents/<name> ของตัวเอง พร้อมไฟล์ prompt.md, context.md และ rules.md AI ภายนอกต่อ MCP แบบ scope เฉพาะโฟลเดอร์นั้น — agent แต่ละตัวจึงไม่ปนความจำกัน

Create an agent สร้าง agent

1. In Cosmos, navigate to /Agents in the folder tree. ใน Cosmos ไปที่ /Agents ใน folder tree
2. Click the ⋯ menu next to it → + New agent. คลิกเมนู ⋯ ข้าง ๆ → + New agent
3. Pick a name (e.g. Reviewer). The folder is created and seeded with the three template files. ตั้งชื่อ (เช่น Reviewer) โฟลเดอร์จะถูกสร้างพร้อมไฟล์ template 3 ไฟล์
4. Edit prompt.md with the agent's system prompt. context.md is for background it should know on every turn. rules.md documents what it can/can't do. แก้ prompt.md ใส่ system prompt ของ agent. context.md ไว้ใส่ background ที่มันต้องรู้ทุก turn. rules.md เขียนว่าทำอะไรได้/ไม่ได้
5. In your AI tool (OpenCode / Cline / Cursor), connect MCP scoped to /Agents/Reviewer. ใน AI tool ของคุณ (OpenCode / Cline / Cursor) ต่อ MCP แบบ scope ไปที่ /Agents/Reviewer

Multiple agents can share one folder if you want a team brain. Otherwise scope each one to its own folder for full isolation.

หลาย agent แชร์โฟลเดอร์เดียวกันได้ถ้าอยากได้ team brain หรือจะแยกโฟลเดอร์ของแต่ละตัวเพื่อให้ isolate กันสมบูรณ์ก็ได้

Seamless backups, elite tools, and ultimate data peace of mind. backup ที่ไม่ต้องคิด, tool ระดับ pro, และความสบายใจเรื่องข้อมูล

Live for alpha invitees today · public sale Q3 2026 · $12/mo or $108/yr เปิดให้ผู้ได้รับเชิญ alpha แล้ววันนี้ · ขายทั่วไป Q3 2026 · $12/เดือน หรือ $108/ปี

• ✓ Cloud backup over TLS — Settings → Files & Backup → Cloud backup. Plaintext at rest today; client-side encryption ships Q3 2026. Cloud backup ผ่าน TLS — Settings → Files & Backup → Cloud backup ตอนนี้เก็บเป็น plaintext ส่วน client-side encryption จะมาใน Q3 2026
• ✓ Daily auto-backup toggle — runs once per 24 h while the app is open toggle auto-backup รายวัน — รันทุก 24 ชม. ขณะแอปเปิดอยู่
• ✓ One-click restore on a new Mac (idempotent merge — never deletes existing data) restore บน Mac เครื่องใหม่ในคลิกเดียว (merge แบบ idempotent — ไม่ลบข้อมูลเดิม)
• ✓ Priority support · early access to features · roadmap input priority support · เข้าถึงฟีเจอร์ใหม่ก่อนใคร · ร่วมออกความเห็นเรื่อง roadmap

Coming Q3 2026 — included for current Pro มาใน Q3 2026 — รวมให้ฟรีสำหรับ Pro ปัจจุบัน

• → Real-time sync between Macs (CRDT-based delta engine) sync แบบ real-time ระหว่าง Mac หลายเครื่อง (delta engine แบบ CRDT)
• → Hosted AI bridge — 1,000 q/month, no API key required hosted AI bridge — 1,000 query/เดือน ไม่ต้องใช้ API key ของตัวเอง

Architecture for the Q3 sync engine is documented in CLOUD_SYNC_ARCHITECTURE.md (available to alpha invitees) if you want to read ahead. Subscribers get the build the moment it ships.

สถาปัตยกรรมของ sync engine ตัว Q3 มีเขียนไว้ใน CLOUD_SYNC_ARCHITECTURE.md (เปิดให้ผู้ได้รับเชิญ alpha) ถ้าอยากอ่านล่วงหน้า ส่วน subscriber จะได้ build ทันทีที่ ship

Common issues. ปัญหาที่เจอบ่อย

Get unstuck. ติดอยู่ตรงไหน บอกเราได้เลย

• → Alpha testers: file issues in the private repo (link in your invitation) Alpha testers: report bug ได้ใน private repo (link อยู่ในอีเมลเชิญ)
• → Everyone else: email cosmos@atitechs.com คนอื่นๆ: อีเมลมาที่ cosmos@atitechs.com
• → Source is private during alpha — invited testers get repo access ช่วง alpha source code ยังเป็น private — testers ที่ได้รับเชิญจะเข้าถึง repo ได้