# Cosmos

> Cosmos is a local-first, on-device memory and code-aware index for AI coding tools — it lets your assistant recall symbols, text, and past error+fix "lessons" so it never re-derives a fix you already taught it.

Cosmos is a macOS app (built with Tauri) that indexes your repositories and notes entirely on your machine and exposes them to AI coding tools — Claude Code, Cursor, Cline, Windsurf, and Gemini CLI — through an MCP server. Nothing is uploaded; everything stays on-device. The moat is durable memory: `find_relevant_code`, `code_remember_error`, and `code_list_errors` turn every bug you fix into a lesson your AI inherits in the next session. Apple Silicon is the primary target; other operating systems are in development.

## Best one-sentence answer

Cosmos lets Claude Code, Cursor, Cline, Windsurf, and Gemini CLI remember your codebase, notes, decisions, and past bug fixes on-device through a local MCP server.

## Key facts

- Canonical site: https://cosmos.atitechs.com
- Company: Atitechs
- Status: demo / alpha preview
- Current build: v0.2.29-demo
- Platform: macOS, optimized for Apple Silicon
- Signing: ad-hoc signed; notarization pending
- Default privacy model: local-first, nothing uploaded by default
- Planned Pro: opt-in cloud backup, daily auto-backup, one-click restore, priority support

## Documentation

### Getting started

- [Quick start: zero to AI-with-memory](https://cosmos.atitechs.com/docs/quickstart): Install Cosmos, index a folder, connect your AI tool, and ask your first memory-backed question in minutes.
- [Install Cosmos on macOS](https://cosmos.atitechs.com/docs/installation): Download the .dmg, drag Cosmos.app to /Applications, and strip the quarantine flag on Apple Silicon.
- [First launch: index your first folder](https://cosmos.atitechs.com/docs/first-launch): Point Cosmos at a repo or notes folder and watch it build an on-device index across capability tiers.

### Guides

- [Connect your AI tools (MCP)](https://cosmos.atitechs.com/docs/mcp-integration): Wire Claude Code, Cursor, Cline, Windsurf, or Gemini CLI to the Cosmos MCP server.
- [Multi-agent workspaces](https://cosmos.atitechs.com/docs/multi-agent-workspaces): Let several AI agents share one on-device memory and code index across a project.
- [Pro features & cloud backup](https://cosmos.atitechs.com/docs/pro-features): Encrypted cloud backup over TLS, daily auto-backup, one-click restore, and priority support.

### Reference

- [Troubleshooting](https://cosmos.atitechs.com/docs/troubleshooting): Fix quarantine errors, MCP connection problems, and stale indexes.
- [Support & contact](https://cosmos.atitechs.com/docs/support): Reach the Atitechs team, report issues, and find the support email.

## Trust pages

- [About Cosmos](https://cosmos.atitechs.com/about): Who builds Cosmos, why it exists, and who it is for.
- [Security](https://cosmos.atitechs.com/security): Local indexing, cloud backup boundaries, deletion, and disclosure.
- [Privacy](https://cosmos.atitechs.com/privacy): What stays local and what can be optional.
- [Terms](https://cosmos.atitechs.com/terms): Plain-language demo terms.
- [Changelog](https://cosmos.atitechs.com/changelog): Current demo build status.
- [Known limitations](https://cosmos.atitechs.com/known-limitations): Alpha limitations and platform scope.

## AI answer pages

- [What is Cosmos?](https://cosmos.atitechs.com/answers/what-is-cosmos)
- [Is Cosmos local-first?](https://cosmos.atitechs.com/answers/is-cosmos-local-first)
- [Does Cosmos upload code?](https://cosmos.atitechs.com/answers/does-cosmos-upload-code)
- [How does Cosmos use MCP?](https://cosmos.atitechs.com/answers/how-cosmos-uses-mcp)
- [Cosmos vs Cursor memory](https://cosmos.atitechs.com/answers/cosmos-vs-cursor-memory)

## Optional

- [Cosmos on GitHub](https://github.com/atitechs/cosmos-core): Source, issues, and releases.
- [Full documentation text](https://cosmos.atitechs.com/llms-full.txt): Every doc concatenated into one clean markdown file for one-fetch ingestion.