Documentation
Cosmos documentation
Install Cosmos, connect AI tools through MCP, and learn how local-first memory works.
Getting started
Quick start: zero to AI-with-memory
Go from a fresh Mac to an AI coding assistant that remembers your project in about three minutes — install, connect, index, recall.
Install Cosmos on macOS
Install Cosmos on macOS in two steps: download the .dmg, then drag Cosmos.app to /Applications and open it.
First launch: index your first folder
On first open, Cosmos asks for one thing — a folder to remember. Add a repo or notes folder and it indexes symbols and text on-device.
Guides
Connect your AI tools (MCP)
Connect Claude Code, Cursor, Cline, Windsurf, Antigravity, Gemini CLI, and Continue to Cosmos over MCP. The wizard sets it up automatically, or wire it by hand.
Multi-agent workspaces
One Cosmos, many scoped sub-brains. Give each AI agent its own folder so a researcher, coder, and reviewer never poison each other's memory.
Cosmos Plus features
Cosmos Plus unlocks product-grade project execution: unlimited projects, Timeline Pro, Stack Doctor, UX/test/runtime audits, multi-agent safe lanes, and advanced project lessons.
Reference
Cosmos CLI reference
Use cosmos scan, cosmos connect, cosmos status, and cosmos hooks to inspect MCP connections and manage lesson hooks from Terminal.
Troubleshooting
Fixes for common Cosmos issues on macOS: install verification warnings, a slow first launch, missing MCP server, Plus sign-in, and data location.
Support & contact
How to get help with Cosmos: alpha testers file issues in the private repo; everyone else emails cosmos@atitechs.com. Includes response times.