Your browser session.
Your AI workflow.

1. Install and start the local relay

Extract the downloaded local-relay archive (logicarelay-local-0.2.1.zip) to a permanent folder. With Node.js 26 or newer installed, open your terminal in that folder and install runtime dependencies:

npm ci --omit=dev

Start the local relay daemon:

node start-relay.cjs

The relay starts on loopback (http://127.0.0.1:38173). The relay can use installed Google Chrome on macOS. If no supported browser is detected, install Playwright Chromium:

npx playwright install chromium

2. Load the Chrome extension

Extract the separate Chrome extension ZIP. Open chrome://extensions, enable Developer mode and choose Load unpacked. Select the extracted folder containing manifest.json. The relay archive is a different package and cannot be loaded as an extension.

3. Connect your MCP client

For JSON-based MCP clients, use your actual absolute paths in place of these examples:

{
  "mcpServers": {
    "LogicaRelay": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/relay/mcp/server.cjs"]
    }
  }
        }

Your client's MCP connection starts the relay. To run it without the client, keep this command open in the extracted relay folder:

node start-relay.cjs

Codex: use the extension's Link button or run the command below in the relay folder, then restart the client. Codex uses TOML; do not paste the JSON example into its configuration.

node mcp/server.cjs --install-codex

GitHub Copilot in VS Code: run the command below in the relay folder, then restart the MCP server in VS Code. The server appears as LogicaRelay.

node mcp/server.cjs --install-vscode

Client support varies by app and workspace. ChatGPT web/mobile cannot start this local stdio server. Update the relay and extension together, and stop the old relay before switching versions.

4. Share a selected site

1. Sign into a website normally in Chrome.
2. Open the extension, connect it to the local relay and choose Share Session with AI.
3. Grant access to that website. The relay receives and encrypts its session on your computer.
4. On Free, ask your client to call list_sessions, then export_playwright_storage_state for the exact shared domain. The plaintext storageState file is saved to private .exports storage with restricted permissions and deleted on Disconnect or Kill Switch pause.
5. Use the returned file with compatible headless browsers (such as Playwright). Start with a small read-only task.

5. Use a Free export with Playwright

Use the exported path in a local script. Replace the URL with the site you selected and are authorized to access:

const { chromium } = require('playwright');
const browser = await chromium.launch();
try {
  const context = await browser.newContext({
    storageState: '/absolute/path/from-the-export.json'
  });
  const page = await context.newPage();
  await page.goto('https://your-authorized-site.example');
  console.log(await page.title());
} finally {
  await browser.close();
}

Wrap this example in an async function in a CommonJS script. Loading a session file does not prove the site accepted the login. If you encounter a sign-in or verification page, complete it yourself in Chrome, sync again and retry.