Integrations
Integrations
Setup guides for connecting memories.sh to your AI coding tools.
memories.sh works with every major AI coding tool. There are two ways to integrate:
- Generated files — Run
memories generate <target>to create a native config file the tool reads automatically - MCP server — Connect the tool to the memories.sh MCP server for live, bidirectional access
Most tools support both methods. Use generated files for simplicity, MCP for live access, or both together.
Quick Setup
The fastest way to set up all your tools at once:
memories initThis automatically detects installed tools and configures MCP for each one.
Supported Tools
Desktop/Terminal Tools
| Tool | Generated File | MCP Support | Auto-detected |
|---|---|---|---|
| Claude Code | CLAUDE.md | Yes | Yes |
| Blackbox CLI | MCP only | Yes | Yes (CLI detection) |
| Cursor | .cursor/rules/memories.mdc | Yes | Yes |
| Windsurf | .windsurf/rules/memories.md | Yes | Yes |
| VS Code / Copilot | .github/copilot-instructions.md | Yes | Yes |
| OpenCode | .agents/ / .opencode/instructions.md | Yes | Yes |
| Factory (Droid) | .agents/ / .factory/instructions.md | Yes | No |
| Cline | .clinerules/memories.md | Yes | No |
| Roo | .roo/rules/memories.md | Yes | No |
| Gemini | GEMINI.md | No | No |
| OpenClaw | ~/.openclaw/workspace/AGENTS.md + ~/.openclaw/workspace/skills/ | No | No |
| Antigravity | .agents/ | Yes | Yes |
| Kiro | .agents/ | Yes | Yes |
| Trae | .agents/ | Yes | Yes |
Web-Based Tools
| Tool | Integration Method |
|---|---|
| v0 by Vercel | MCP via SSE (Server-Sent Events) |
Universal Target
The agents target generates the canonical .agents/ directory:
| Tool | Docs |
|---|---|
| Amp | Sourcegraph's coding agent |
| Codex | OpenAI's CLI agent |
| Goose | Block's open-source agent |
| Kilo | Kilo coding assistant |
| Kiro | AWS's agentic AI IDE |
| OpenCode | Terminal AI assistant |
memories generate agentsManual MCP Setup
For tools that aren't auto-detected, add to the tool's MCP config:
{
"mcpServers": {
"memories": {
"command": "npx",
"args": ["-y", "@memories.sh/cli", "serve"]
}
}
}Remote/Web Tools (SSE)
For web-based tools like v0 that can't spawn local processes, use SSE transport:
memories serve --sse --port 3030Then configure the tool to connect to http://localhost:3030/mcp. See the v0 integration guide for details.
Config File Locations
| Tool | MCP Config Location |
|---|---|
| Blackbox CLI | Managed via blackbox mcp ... commands |
| Cursor | .cursor/mcp.json or ~/.cursor/mcp.json |
| Claude Code | .mcp.json (project) or ~/.mcp.json (global) |
| Windsurf | .windsurf/mcp.json |
| VS Code | .vscode/mcp.json |
| OpenCode | opencode.json (project) or ~/.config/opencode/opencode.json (global) |
| Factory | .factory/mcp.json |
| Kiro | .kiro/settings/mcp.json |
| Kilo | .kilo/mcp.json |
| Trae | .trae/mcp.json |
| Antigravity | .antigravity/mcp.json (project) or ~/.gemini/antigravity/mcp_config.json (global, when IDE-managed) |
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
MCP Schema Matrix
| Schema Family | Used By | Shape |
|---|---|---|
| Cursor-style JSON | Cursor, Windsurf, Kiro, Kilo, Trae, Antigravity, Factory, Amp | { "mcpServers": { "memories": { "command": "npx", "args": [...] } } } |
| Claude-style JSON | Claude Code, Claude Desktop | { "mcpServers": { "memories": { "command": "npx", "args": [...] } } } |
| VS Code-style JSON | VS Code MCP config | { "servers": { "memories": { "command": "npx", "args": [...] } } } |
| OpenCode schema | OpenCode (opencode.json) | { "$schema": "https://opencode.ai/config.json", "mcp": { "memories": { "type": "local", "command": ["npx", ...] } } } |
| CLI-managed MCP | Blackbox CLI | Managed via blackbox mcp add ... (no stable file path contract documented) |
| Workspace artifacts | OpenClaw | ~/.openclaw/workspace/{AGENTS,SOUL,TOOLS,IDENTITY,USER,HEARTBEAT,BOOTSTRAP,BOOT,MEMORY}.md + memory/*.md + skills/**/* |
See each tool's page for detailed setup instructions.