​

CLI Auto-Installer

​

Quickstart

npx -y install-memwyre

​

Authentication & OAuth Callback Flow

┌──────────────┐      1. Start Loopback       ┌──────────────┐
│  Local CLI   ├─────────────────────────────►│ Local Port   │
│  Installer   │                              │ (Randomized) │
└──────┬───────┘                              └──────┬───────┘
       │                                             ▲
       │ 2. Open Web Browser                         │ 4. HTTP POST
       ▼                                             │    Bearer Token
┌──────────────┐      3. User logs in         ┌──────┴───────┐
│ memwyre.tech │─────────────────────────────►│ Web App Auth │
│ /login       │                              │ Dashboard    │
└──────────────┘                              └──────────────┘

1. Local Server Start: The script starts a temporary, lightweight Express server on an ephemeral port (e.g. http://localhost:50310).
2. Browser Redirection: The script opens your default web browser and redirects you to the authentication page: https://memwyre.tech/login?cli_port=50310
3. Authentication: You sign in with Google, GitHub, or email.
4. Token Delivery: Once authenticated, the web application sends the secure Bearer Token to the local loopback address (http://localhost:50310/callback).
5. Config Write: The CLI captures the token, writes it to your global configurations (like mcp.json and claude_desktop_config.json), and shuts down the loopback listener.

​

What the Installer Does

​

1. Cursor

• Configuration Path: ~/.cursor/mcp.json
• JSON Structure:
  "memwyre": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://server.memwyre.tech/mcp", "--header", "Authorization:Bearer <token>"]
  }
  

​

2. VS Code (MCP Client)

• Configuration Path: %APPDATA%\Code\User\mcp.json (Windows) or ~/Library/Application Support/Code/User/mcp.json (macOS)
• JSON Structure:
  "memwyre": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://server.memwyre.tech/mcp", "--header", "Authorization:Bearer <token>"]
  }
  

​

3. Claude Desktop

• Configuration Path: %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• JSON Structure:
  "mcpServers": {
    "memwyre": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://server.memwyre.tech/mcp", "--header", "Authorization:Bearer <token>"]
    }
  }
  

​

4. Codex

• Configuration Path: ~/.codex/config.toml
• TOML Structure:
  [mcp_servers.memwyre]
  enabled = true
  url = "https://server.memwyre.tech/mcp"
  http_headers = { Authorization = "Bearer <token>" }
  

​

5. Claude Code

• Action: Executes the Claude CLI registration command directly in your shell:
  claude mcp add memwyre -- npx -y mcp-remote https://server.memwyre.tech/mcp --header "Authorization:Bearer <token>"
  

​

6. Antigravity

• Configuration Path: ~/.gemini/config/mcp_config.json
• JSON Structure:
  "memwyre": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://server.memwyre.tech/mcp", "--header", "Authorization:Bearer <token>"]
  }
  

​

Troubleshooting

​

Port Conflict Error

Error: listen EADDRINUSE: address already in use 127.0.0.1:XXXX

• Solution: The script automatically attempts to find an open port, but firewall rules or VPN clients can block local loopback binds. Disable active VPNs or corporate proxy configurations during authentication.

​

Token Expiration Warning

• Run the installer again (npx -y install-memwyre) to renew your token and update configuration files automatically.
• Alternatively, generate an API key from your web dashboard and manually set it as MEMWYRE_API_KEY in your client’s environment block.