Getting started
Quick start: zero to AI-with-memoryเริ่มต้นใช้งาน: จากศูนย์สู่ AI ที่มีความจำ
Five steps take you from a fresh Mac to an AI coding tool that remembers your codebase: install Cosmos, connect your AI tool, index a folder, ask a memory-aware question, then save your first lesson.ห้าขั้นตอนพา Mac เครื่องใหม่ของคุณไปสู่เครื่องมือเขียนโค้ด AI ที่จดจำ codebase ของคุณได้: ติดตั้ง Cosmos, เชื่อมต่อเครื่องมือ AI, index โฟลเดอร์, ถามคำถามที่ต้องใช้ความจำ แล้วบันทึกบทเรียนแรกของคุณ
Get from a fresh Mac to an AI coding assistant that remembers your project in about three minutes. This quick start walks you through installing Cosmos, connecting your AI tool over MCP, indexing your first folder, asking a memory-aware question, and teaching Cosmos its first lesson.
What you'll need
- A Mac (Apple Silicon is the primary, fully supported target).
- An AI coding tool: Claude Code, Cursor, Cline, Windsurf, or Gemini CLI.
- A code repository or notes folder you want the AI to remember.
1. Install Cosmos
Download the .dmg, drag Cosmos.app into /Applications, then strip the macOS quarantine flag so the app opens.
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
Full walkthrough: Install Cosmos on macOS.
2. Connect your AI tool
On first launch, the onboarding wizard installs the Cosmos MCP server into every AI coding tool it detects — Claude Code, Cursor, Cline, Windsurf, and Gemini CLI. You can re-run it anytime from Integrations → AI Coding Tools.
Details and manual config: Connect your AI tools (MCP).
3. Add a code folder
Point Cosmos at any repo you want the AI to remember. Cosmos indexes symbols and text on-device, in the background — nothing is uploaded; everything stays on your machine.
Step-by-step: First launch: index your first folder.
4. Ask your AI anything
Open your AI tool and ask a question that needs project memory. Try:
What past fixes should I know before editing this project?
Cosmos answers from your indexed code and any lessons you have saved, so the AI starts the task already aware of your project's history.
5. Teach it a lesson
After you fix a bug, tell the AI "remember this." Cosmos stores the symptom, root cause, and fix as a lesson, then recalls it next time — so the AI never re-derives a fix you already taught it. The more you use it, the more your project's memory compounds.
What just happened?
You now have an AI assistant with persistent, on-device memory of your codebase. Every lesson you save is recalled automatically the next time it is relevant.
How long does the quick start take?
About three minutes for your first folder. Indexing continues in the background while you keep working.
Do I need an internet connection?
Only to download the app. Indexing and recall run entirely on your machine — nothing is uploaded.
พา Mac เครื่องใหม่ของคุณไปสู่ผู้ช่วยเขียนโค้ด AI ที่จดจำโปรเจกต์ของคุณได้ภายในเวลาประมาณสามนาที คู่มือเริ่มต้นใช้งานนี้จะพาคุณติดตั้ง Cosmos, เชื่อมต่อเครื่องมือ AI ผ่าน MCP, index โฟลเดอร์แรกของคุณ, ถามคำถามที่ต้องใช้ความจำ และสอนบทเรียนแรกให้ Cosmos
สิ่งที่คุณต้องมี
- เครื่อง Mac (Apple Silicon คือเป้าหมายหลักที่รองรับเต็มรูปแบบ)
- เครื่องมือเขียนโค้ด AI สักตัว: Claude Code, Cursor, Cline, Windsurf หรือ Gemini CLI
- โค้ด repository หรือโฟลเดอร์บันทึกที่คุณอยากให้ AI จดจำ
1. ติดตั้ง Cosmos
ดาวน์โหลดไฟล์ .dmg, ลาก Cosmos.app ไปไว้ใน /Applications แล้วลบ flag quarantine ของ macOS ออกเพื่อให้แอปเปิดได้
xattr -cr /Applications/Cosmos.app
open /Applications/Cosmos.app
ดูคู่มือฉบับเต็ม: ติดตั้ง Cosmos บน macOS
2. เชื่อมต่อเครื่องมือ AI ของคุณ
เมื่อเปิดใช้งานครั้งแรก wizard onboarding จะติดตั้ง Cosmos MCP server เข้ากับเครื่องมือเขียนโค้ด AI ทุกตัวที่ตรวจพบ — Claude Code, Cursor, Cline, Windsurf และ Gemini CLI คุณสามารถเรียก wizard นี้ขึ้นมาทำใหม่ได้ทุกเมื่อจาก Integrations → AI Coding Tools
รายละเอียดและการตั้งค่าด้วยตัวเอง: เชื่อมต่อเครื่องมือ AI ของคุณ (MCP)
3. เพิ่มโฟลเดอร์โค้ด
ชี้ Cosmos ไปที่ repo ใดก็ได้ที่คุณอยากให้ AI จดจำ Cosmos จะ index symbol และข้อความบนเครื่องของคุณเองในเบื้องหลัง — ไม่มีการอัปโหลดอะไรทั้งสิ้น ทุกอย่างอยู่บนเครื่องของคุณ
ทีละขั้นตอน: เปิดใช้งานครั้งแรก: index โฟลเดอร์แรกของคุณ
4. ถาม AI ของคุณได้ทุกเรื่อง
เปิดเครื่องมือ AI ของคุณแล้วถามคำถามที่ต้องใช้ความจำของโปรเจกต์ ลองดู:
มีการแก้ไขในอดีตอะไรบ้างที่ฉันควรรู้ก่อนจะแก้โปรเจกต์นี้?
Cosmos ตอบจากโค้ดที่ index ไว้และบทเรียนใด ๆ ที่คุณบันทึกไว้ ทำให้ AI เริ่มทำงานโดยรับรู้ประวัติของโปรเจกต์คุณตั้งแต่ต้น
5. สอนบทเรียนให้มัน
หลังจากที่คุณแก้บั๊กเสร็จ ให้บอก AI ว่า "จำสิ่งนี้ไว้" Cosmos จะเก็บอาการ (symptom), สาเหตุที่แท้จริง (root cause) และวิธีแก้ไว้เป็นบทเรียน แล้วเรียกกลับมาใช้ในครั้งถัดไป — เพื่อให้ AI ไม่ต้องคิดหาวิธีแก้ที่คุณสอนไปแล้วซ้ำอีก ยิ่งคุณใช้มากเท่าไหร่ ความจำของโปรเจกต์คุณก็ยิ่งสะสมทบต้นมากขึ้น
เกิดอะไรขึ้นบ้าง?
ตอนนี้คุณมีผู้ช่วย AI ที่มีความจำของ codebase แบบถาวรและอยู่บนเครื่องของคุณเองแล้ว ทุกบทเรียนที่คุณบันทึกไว้จะถูกเรียกกลับมาใช้โดยอัตโนมัติในครั้งถัดไปที่เกี่ยวข้อง
การเริ่มต้นใช้งานนี้ใช้เวลานานแค่ไหน?
ประมาณสามนาทีสำหรับโฟลเดอร์แรกของคุณ การ index จะดำเนินต่อไปในเบื้องหลังขณะที่คุณทำงานต่อได้
ฉันจำเป็นต้องเชื่อมต่ออินเทอร์เน็ตไหม?
เฉพาะตอนดาวน์โหลดแอปเท่านั้น การ index และการเรียกความจำกลับมาใช้ทำงานบนเครื่องของคุณทั้งหมด — ไม่มีการอัปโหลดอะไรทั้งสิ้น
- Atitechs EngineeringMaintainer
- Atitechs DXDeveloper Experience