AI Tool Setup

Detailed configuration guides for each supported AI coding tool. All require the same two steps: add Engrams to the MCP config, then run engrams init.

Roo Code

Add to ~/.roo/mcp.json or <project>/.roo/mcp.json:

{
  "mcpServers": {
    "engrams": {
      "command": "uvx",
      "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
    }
  }
}

engrams init --tool roo

This installs the complete Roo scaffold:

• .roo/rules/engrams_strategy — Engrams memory strategy rules
• .roomodes — 5 custom Flow modes (Code, Architect, Ask, Debug, Orchestrator)
• .roo/system-prompt-flow-* — Per-mode system prompts with Engrams integration

Use --skip-prompts to install only the strategy rules without system prompt files.

Cline

In VS Code, open Settings → Extensions → Cline → MCP Servers and add:

{
  "engrams": {
    "command": "uvx",
    "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
  }
}

engrams init --tool cline

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "engrams": {
      "command": "uvx",
      "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
    }
  }
}

engrams init --tool cursor

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engrams": {
      "command": "uvx",
      "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
    }
  }
}

engrams init --tool windsurf

Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "engrams": {
      "command": "uvx",
      "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
    }
  }
}

engrams init --tool claude-code

This creates a CLAUDE.md file in your project root with the Engrams strategy.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "engrams": {
      "command": "uvx",
      "args": ["--reinstall", "--from", "engrams-mcp", "engrams-mcp", "--mode", "stdio"]
    }
  }
}

engrams init --tool claude-desktop

This prints custom instructions to paste into Claude Desktop's Project Instructions field.

Any other MCP client

engrams init --tool generic

This creates engrams_strategy.md — a tool-agnostic strategy document you can paste into any AI's system prompt or custom instructions field.