AliasMode
Download free

macOS source run

Run the AliasMode dashboard from source on macOS.

Clone the Apache-2.0 client, install dependencies with Bun, and start the dashboard and local runtime on macOS. The Windows installer remains the packaged release.

Open the source repositorySee the packaged Windows release

Commands match the current repository README. The packaged Windows installer (0.1.0-beta.47) is the supported release; macOS runs from source at the current source version (0.1.0-beta.47). · Tested 2026-09-01

Direct answer

macOS has no native installer. Install Bun, run bun install in the repository, then start the app with bun cli.ts start. CloakBrowser installs through its approved installer at no extra cost, and AliasMode pins the resulting binary hash.

BunInstall, test, run
LoopbackDashboard and API binding
Apache-2.0Client source license

Requirements

  • Bun, a current release for macOS
  • Rust and Tauri prerequisites for desktop builds
  • A supported CloakBrowser installation
  • Git for cloning the repository

What works on macOS today

There is no native macOS installer. The download page ships a Windows installer only. On macOS, AliasMode runs from the Apache-2.0 client source with Bun, which gives you the dashboard and the local runtime on that machine.

  • React dashboard served locally
  • Bun/TypeScript sidecar for the local runtime
  • CloakBrowser process lifecycle
  • Local SQLite profile storage
  • Portable session capture and restore
  • Optional AdsPower-compatible API bound to loopback only

Install Bun and clone the repository

  1. Install Bun

    Install Bun with the official script, then confirm the version on your PATH.

    curl -fsSL https://bun.sh/install | bash
bun --version

  2. Clone the client repository

    The repository contains the Apache-2.0 desktop client and local runtime.

    git clone https://github.com/aliasmode/aliasmode.git
cd aliasmode

  3. Install dependencies

    Bun reads the lockfile and installs pinned dependencies.

    bun install

Run the dashboard

Start the app from the repository root. The dashboard and the compatibility API bind to loopback only, so nothing is exposed to the network by default.

bun cli.ts start
Create your first profile Learn what a profile stores

Run the tests

Before you rely on a source build, run the test suite. It covers the profile store, launcher, and API behavior, and it is the fastest way to confirm the checkout is healthy.

bun test

CloakBrowser on macOS

AliasMode installs CloakBrowser through its approved official installer and pins the resulting executable hash, so a source run launches the same verified binary every time. The CloakBrowser binary is not part of the repository and is not covered by the Apache-2.0 license.

Read the CloakBrowser setup

Limitations compared with Windows

  • No native installer: the packaged release with SHA-256 verification is Windows only
  • Desktop builds require the Rust and Tauri toolchains installed locally
  • The packaged aliasmode-mcp helper ships with the Windows installer; on a source checkout, run the equivalent entry point at agent/aliasmode-mcp.ts with Bun
  • Remote MCP hosting is documented for the Windows device; point MCP clients on your Mac at a running Windows host over Remote MCP instead
Control a Windows host over Remote MCP Review the MCP tool surface

FAQ

Is there a macOS installer?

No. macOS runs from source with Bun. The Windows installer is the only packaged release today.

Can a macOS source run synchronize with AliasMode Cloud?

Cloud mode comes from the same client source. A source run can sign in and synchronize portable profiles like any other device.

Which version does a source run report?

The current source version (0.1.0-beta.47), not the released installer (0.1.0-beta.42).

Sources and verification

  • AliasMode repository · README — Bun development commands, runtime components, and CloakBrowser notes (checked September 2026)
  • AliasMode repository · LICENSE — Apache-2.0 client source (checked September 2026)
  • AliasMode repository · NOTICE — third-party component and runtime licensing boundaries (checked September 2026)
  • Bun · Bun installation documentation (checked September 2026)

Public product details can change after the check date. Facts are re-checked on a monthly cycle.

Sources