Cosmos Core

Local-first memory and code intelligence for AI coding tools.

Cosmos Core is the open-source engine behind Cosmos. It runs a local Model Context Protocol (MCP) server that indexes code structure, local notes, and bug-fix lessons, then serves bounded context to AI coding tools before they edit your project.

The full Cosmos desktop app adds the visual workspace, one-click MCP installer, Timeline Pro, Stack Doctor, UX/test/runtime audit gates, multi-agent safe lanes, and app-level onboarding. Download it at cosmos.atitechs.com.

---

What This Repo Includes

Capability	Cosmos Core	Cosmos Desktop
Local SQLite + FTS memory	✅	✅
Code indexer + symbols	✅	✅
MCP server	✅ stdio CLI	✅ one-click installer
Past bug-fix lessons	✅	✅
Timeline Pro	❌	✅ Plus
Stack Doctor	❌	✅ Plus
UX/test/runtime audit gates	❌	✅ Plus
Multi-agent safe lanes	❌	✅ Plus
Visual app workspace	❌	✅
Hosted backup/sync/hosted MCP	Roadmap	Roadmap

---

Language Coverage

Cosmos indexes 30 source extensions across confidence tiers:

Tier	Languages / files	Notes
Strong AST	Python, TypeScript, JavaScript, Rust, Go, Java, C#	High-confidence symbols, imports, and call graph
Beta AST	Kotlin, Dart, PHP, Ruby, Swift, C, C++	Useful AST extraction with guarded fallbacks
Search / index	Vue, Svelte, SQL, HTML, CSS	File-level search and context retrieval

Not every language has identical call-graph depth yet. The engine uses confidence tiers so AI agents can rely on AST when it is strong and fall back to bounded file search when appropriate.

---

Supported AI Tools

Cosmos Core exposes one MCP server that can be wired into MCP-aware AI coding tools, including:

• Claude Code
• Cursor
• Cline
• Windsurf
• Antigravity
• Gemini CLI
• Continue

The desktop app automates setup. For the core repo, configure your AI client manually.

---

Run The Core MCP Server

1. Install

pip install -r requirements-mcp.txt

2. Configure Your AI Client

Point your MCP client at the local server module:

{
  "mcpServers": {
    "cosmos-core": {
      "command": "python",
      "args": ["-m", "core.api.mcp_server"],
      "env": {
        "PYTHONPATH": "/path/to/cosmos-core"
      }
    }
  }
}

Replace /path/to/cosmos-core with this repository's absolute path.

---

Privacy

• Local-first by default: indexing and SQLite search run on your machine.
• No code telemetry by default: code snippets, filenames, and repository contents are not uploaded just to use the core engine.
• Open local data: memory and lessons are stored in SQLite.

Hosted backup, hosted sync, hosted MCP, and cloud AI quota are roadmap services, not current Cosmos Plus promises.