install.cmd

@echo off
REM Engram installer for Windows CMD
REM Usage: curl -fsSL https://engram-memory.com/install.cmd -o install.cmd && install.cmd && del install.cmd

setlocal enabledelayedexpansion

if defined ENGRAM_MCP_URL (
    set "MCP_URL=%ENGRAM_MCP_URL%"
) else (
    set "MCP_URL=https://www.engram-memory.com/mcp"
)
set "INVITE_KEY="

REM ── Install engram CLI ───────────────────────────────────────────
echo.
echo Installing engram CLI...

where uv >nul 2>&1
if %errorlevel% neq 0 (
    echo   Fetching uv...
    powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"
    set "PATH=%USERPROFILE%\.local\bin;%PATH%"
)

uv tool install engram-team --upgrade --quiet >nul 2>&1
if %errorlevel% equ 0 (
    set "PATH=%USERPROFILE%\.local\bin;%PATH%"
    echo   + engram CLI installed

    if not exist "%USERPROFILE%\.engram" mkdir "%USERPROFILE%\.engram"
    echo ENGRAM_SERVER_URL=https://www.engram-memory.com> "%USERPROFILE%\.engram\credentials"
    if not "%INVITE_KEY%"=="" echo ENGRAM_INVITE_KEY=%INVITE_KEY%>> "%USERPROFILE%\.engram\credentials"

    engram install >nul 2>&1
    if %errorlevel% equ 0 ( echo   + auto-commit hooks installed )
) else (
    echo   ! CLI install failed -- run manually: uv tool install engram-team
)

REM ── Require Python 3 ─────────────────────────────────────────────
where python3 >nul 2>&1
if %errorlevel% equ 0 (
    set "PY=python3"
) else (
    where python >nul 2>&1
    if %errorlevel% equ 0 (
        set "PY=python"
    ) else (
        echo Python 3 is required but not found. Please install it first.
        exit /b 1
    )
)


REM ── Write shared Python patcher ──────────────────────────────────
set "PATCHER=%TEMP%\engram_patch.py"
(
echo import json, sys, os
echo.
echo def load^(path^):
echo     if not os.path.exists^(path^): return {}
echo     try:
echo         raw = open^(path^).read^(^).strip^(^)
echo         return json.loads^(raw^) if raw else {}
echo     except json.JSONDecodeError: return {}
echo.
echo fmt, f, u, k = sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4]
echo c = load^(f^)
echo d = os.path.dirname^(f^)
echo if d: os.makedirs^(d, exist_ok=True^)
echo if fmt == 'url':
echo     c.setdefault^('mcpServers', {}^)
echo     e = {'url': u}
echo     if k: e['headers'] = {'Authorization': 'Bearer ' + k}
echo     c['mcpServers']['engram'] = e
echo elif fmt == 'windsurf':
echo     c.setdefault^('mcpServers', {}^)
echo     e = {'serverUrl': u}
echo     if k: e['headers'] = {'Authorization': 'Bearer ' + k}
echo     c['mcpServers']['engram'] = e
echo elif fmt == 'vscode':
echo     c.setdefault^('servers', {}^)
echo     e = {'type': 'http', 'url': u}
echo     if k: e['headers'] = {'Authorization': 'Bearer ' + k}
echo     c['servers']['engram'] = e
echo elif fmt == 'claude-code':
echo     c.setdefault^('mcpServers', {}^)
echo     e = {'type': 'http', 'url': u}
echo     if k: e['headers'] = {'Authorization': 'Bearer ' + k}
echo     c['mcpServers']['engram'] = e
echo elif fmt == 'claude-desktop':
echo     c.setdefault^('mcpServers', {}^)
echo     a = ['-y', 'mcp-remote@latest', u]
echo     if k: a.extend^(['--header', 'Authorization: Bearer ' + k]^)
echo     c['mcpServers']['engram'] = {'command': 'npx', 'args': a}
echo elif fmt == 'opencode':
echo     c.setdefault^('mcp', {}^)
echo     e = {'type': 'remote', 'url': u, 'enabled': True}
echo     if k: e['headers'] = {'Authorization': 'Bearer ' + k}
echo     c['mcp']['engram'] = e
echo json.dump^(c, open^(f, 'w'^), indent=2^)
echo print^('  + ' + f^)
) > "%PATCHER%"

REM ── Detect and patch MCP clients ────────────────────────────────
echo.
echo Detecting MCP clients...
set "PATCHED=0"

REM Claude Desktop — npx mcp-remote bridge
if exist "%APPDATA%\Claude" (
    call :patch claude-desktop "%APPDATA%\Claude\claude_desktop_config.json"
)

REM Claude Code — {type: "http", url} in ~/.claude.json
set "CC_FOUND=0"
if exist "%USERPROFILE%\.claude"      set "CC_FOUND=1"
if exist "%USERPROFILE%\.claude.json" set "CC_FOUND=1"
if "%CC_FOUND%"=="1" (
    call :patch claude-code "%USERPROFILE%\.claude.json"
)

REM Cursor
if exist "%USERPROFILE%\.cursor" (
    call :patch url "%USERPROFILE%\.cursor\mcp.json"
)

REM VS Code — {servers: {type: "http", url}}
if exist "%APPDATA%\Code" (
    call :patch vscode "%APPDATA%\Code\User\mcp.json"
)

REM Windsurf — serverUrl
if exist "%USERPROFILE%\.codeium\windsurf" (
    call :patch windsurf "%USERPROFILE%\.codeium\windsurf\mcp_config.json"
)

REM Kiro
if exist "%USERPROFILE%\.kiro" (
    call :patch url "%USERPROFILE%\.kiro\settings\mcp.json"
)

REM Amazon Q Developer
if exist "%USERPROFILE%\.aws\amazonq" (
    call :patch url "%USERPROFILE%\.aws\amazonq\mcp.json"
)

REM Trae (ByteDance)
if exist "%APPDATA%\Trae" (
    call :patch url "%APPDATA%\Trae\User\mcp.json"
)

REM JetBrains / Junie
if exist "%USERPROFILE%\.junie" (
    call :patch url "%USERPROFILE%\.junie\mcp\mcp.json"
)

REM Cline (VS Code extension)
if exist "%USERPROFILE%\Documents\Cline" (
    call :patch url "%USERPROFILE%\Documents\Cline\MCP\cline_mcp_settings.json"
)

REM Roo Code (VS Code extension, Cline fork)
if exist "%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline" (
    call :patch url "%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json"
)

REM OpenCode — {mcp: {type: "remote", url}}
if exist "%USERPROFILE%\.config\opencode" (
    call :patch opencode "%USERPROFILE%\.config\opencode\config.json"
)

del "%PATCHER%" >nul 2>&1

REM ── Install Claude Code skill (global, all sessions) ─────────────
set "SKILL_DIR=%USERPROFILE%\.claude\skills"
set "SKILL_FILE=%SKILL_DIR%\set-up-engram-for-my-team.md"
if not exist "%SKILL_DIR%" mkdir "%SKILL_DIR%"
(
echo # Set Up Engram for My Team
echo.
echo Guide the user through configuring the Engram MCP server in their IDE.
echo.
echo ## CRITICAL -- Correct MCP URL
echo.
echo The ONLY correct Engram MCP endpoint is:
echo.
echo     https://www.engram-memory.com/mcp
echo.
echo DO NOT invent subdomains like mcp.engram-memory.com or mcp.engram.app -- they do not exist.
echo DO NOT omit the www prefix. Always use exactly:
echo.
echo     https://www.engram-memory.com/mcp
echo.
echo ## Step 1 -- Check existing config and auto-fix wrong URLs
echo.
echo Read ~/.claude.json and .mcp.json ^(if they exist^). If either contains an "engram"
echo entry under mcpServers with a WRONG url ^(anything other than https://www.engram-memory.com/mcp,
echo e.g. mcp.engram.app or mcp.engram-memory.com^), fix it to https://www.engram-memory.com/mcp and tell the user you
echo corrected it.
echo.
echo If Engram is already correctly configured, tell the user and skip to Step 4.
echo.
echo ## Step 2 -- Ask two questions in a single AskUserQuestion call
echo.
echo **Question 1 -- header: "Engram type"**
echo question: "What Engram implementation do you want to use?"
echo options:
echo 1. label: "Engram hosted server ^(Recommended^)" -- description: "Use the managed Engram MCP server at engram-memory.com -- no installation needed, easiest to get started"
echo 2. label: "Self-hosted / custom" -- description: "You have your own Engram server URL or a local binary you want to connect to"
echo 3. label: "Walk me through the options and tradeoffs" -- description: "Explain the differences before I decide"
echo 4. label: "Chat about this" -- description: "I have a question first"
echo.
echo **Question 2 -- header: "Scope"**
echo question: "Where should Engram be configured?"
echo options:
echo 1. label: "User-level ^(~/.claude.json^) ^(Recommended^)" -- description: "Available across all your Claude Code projects, not tied to any single repo"
echo 2. label: "Project-level ^(.mcp.json^)" -- description: "Checked into this repo -- all agents working in this directory share the config"
echo 3. label: "Chat about this" -- description: "I have a question first"
echo.
echo If the user picks "Walk me through the options" or "Chat about this", answer their question then re-ask.
echo.
echo ## Step 3 -- Write config
echo.
echo IMPORTANT: The url MUST be exactly https://www.engram-memory.com/mcp -- no other domain.
echo.
echo Hosted + User-level: merge into ~/.claude.json with mcpServers.engram = {type: "http", url: "https://www.engram-memory.com/mcp"}
echo Hosted + Project-level: merge into .mcp.json with same entry
echo Self-hosted: ask for URL first, then write accordingly
echo.
echo ## Step 4 -- Next steps
echo.
echo Tell the user which file was written, that the MCP URL is https://www.engram-memory.com/mcp, to restart Claude Code, then call engram_status^(^) to run engram_init or engram_join.
) > "%SKILL_FILE%"
echo   + %SKILL_FILE%

REM ── Result ───────────────────────────────────────────────────────
echo.
if %PATCHED% equ 0 (
    echo No MCP clients detected. Manually add to your IDE's MCP config:
    echo.
    echo   Remote MCP URL: %MCP_URL%
    if not "%INVITE_KEY%"=="" echo   Header: Authorization: Bearer %INVITE_KEY%
    echo.
    echo Then restart your IDE.
) else (
    echo Done!
    echo.
    echo   Restart your terminal, then run:
    echo.
    echo     engram                 - get started
    echo     engram conflicts       - review memory conflicts
    echo     engram search ^<term^>   - query workspace memory
    echo.
    echo   Or restart your IDE and ask your agent:
    echo.
    if "%INVITE_KEY%"=="" (
        echo     "Set up Engram for my team"         - create a new workspace
        echo     "Join Engram with key ek_live_..."  - join a teammate's workspace
    ) else (
        echo     "Set up Engram"  - your agent will connect to your workspace
    )
)
echo.
goto :eof

:patch
%PY% "%PATCHER%" %~1 "%~2" "%MCP_URL%" "%INVITE_KEY%"
set /a PATCHED+=1
goto :eof