AliasMode documentation

Set up profiles, proxies, Cloud, and automation.

Use these guides to move from installation to a working browser profile, then add proxy settings, Local API control, or Playwright automation.

Start the setup guide Download AliasMode

Setup

Install AliasMode and open your first profile.

DocsGetting started

Install AliasMode and CloakBrowser, choose Cloud or Local mode, create a browser profile, and open your first isolated session.

Open DocsCloakBrowser

Install the CloakBrowser runtime AliasMode includes at no extra cost to open persistent browser profiles on Windows, and review its bot-detection test results.

Open DocsmacOS from source

Build the AliasMode dashboard on macOS with Bun, run the local runtime from source, and review how a source run differs from the packaged Windows installer.

Open

AI clients and MCP

Local MCP tools, Remote MCP connectors, and agent clients.

DocsMCP reference

Configure the AliasMode MCP server over local stdio, review every AliasMode and Playwright tool per release, and verify the list your client receives.

Open DocsClaude and ChatGPT

Connect a pinned AliasMode Windows device through remote MCP and OAuth, select a persistent browser profile, and use Playwright page actions.

Open DocsLinux with Remote MCP

Point an MCP client on Linux at your pinned AliasMode Windows device over Remote MCP and run profile and Playwright actions without a Linux app.

Open

Configure the workflow

Understand profiles and proxies.

DocsBrowser profiles

Learn how AliasMode keeps cookies, storage, proxy settings, user agents, screen values, extensions, tags, and profile data separated.

Open DocsProxies

Add HTTP, HTTPS, or SOCKS5 proxies to AliasMode profiles, import credentials, run preflight checks, and verify the exit location.

Open

Automation and support

Control AliasMode from code and fix common issues.

DocsLocal API

Use the AliasMode Local API for browser control, profiles, groups, cookies, cache, and CDP automation. Supports an AdsPower-compatible subset.

Open DocsPlaywright

Start an AliasMode profile through the Local API and attach Playwright to its persistent browser session over CDP.

Open DocsTroubleshooting

Fix common AliasMode installation, CloakBrowser, proxy, Local API, profile-opening, and Cloud synchronization problems.

Open

Start with a working profile

Install the Windows desktop client and CloakBrowser. Choose Cloud or Local, create a profile, confirm its settings, and open the browser.

Follow getting started

Connect Claude or ChatGPT

Cloud mode gives one Windows installation a pinned remote MCP URL. Add that URL to Claude or ChatGPT, sign in to AliasMode, and use Playwright tools in the selected profile.

Connect an AI client

Configure the workflow

Learn what a profile stores, assign an HTTP, HTTPS, or SOCKS5 proxy, and organize repeatable profile groups.

Understand browser profiles Set up proxies

Connect internal tools

Use the supported Local API subset for profile and browser control. Attach Playwright to a started browser over CDP.

Read the API reference Connect Playwright