Connect your AI tools (MCP)

Cosmos exposes your on-device memory and code index through an MCP server. The onboarding wizard installs it into every AI coding tool it detects, so most people never touch a config file. If you'd rather wire it manually, point each tool at the Cosmos launcher.

Automatic setup (recommended)

The onboarding wizard installs everything automatically. To run it again, open Integrations → AI Coding Tools and click connect for each tool. The wizard writes the correct MCP config to the right path for Claude Code, Cursor, Cline, Windsurf, and Gemini CLI.

Wire it by hand

All tools launch the same MCP server via this path:

/Applications/Cosmos.app/Contents/Resources/start-mcp.sh

Claude Code

Add an .mcp.json file in any project to enable Cosmos for that project:

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

Cursor, Cline, Windsurf, Gemini CLI

Each tool has its own MCP config file in its own location. The wizard writes the same launcher (start-mcp.sh) into the correct path for whichever tool you connect. To configure by hand, add a cosmos server entry pointing command at the launcher path above, using that tool's MCP config format.

Tools you get

Once connected, your AI gains these Cosmos tools:

• find_relevant_code — symptom plus past-lesson recall in one round-trip.
• code_remember_error / code_list_errors — the moat: your accumulated bug-and-fix lessons, recalled before the AI re-derives a fix.
• code_skeleton / code_get_symbol — read structure and individual symbols without loading whole files.
• code_callers / code_callees / code_uses — real call-graph edges, not string matches.
• code_explain_project / code_diff / code_context_bundle — orientation, change review, and one-shot context.
• brain_search / brain_remember / brain_session_context / brain_pattern_recall — personal notes, decisions, and conventions across sessions.

Why doesn't my AI see the cosmos server?

Restart the AI tool after the wizard installs the server — most tools only read MCP config at startup. Then verify the connection with /mcp, which should list a server named cosmos. If it still doesn't appear, re-run the wizard from Integrations → AI Coding Tools.