> ## Documentation Index
> Fetch the complete documentation index at: https://continuum-three-olive.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Continuum on macOS, Windows, Linux, the terminal, iPhone, Watch, Android, or nowhere at all — the web app needs no install.

Continuum ships on eight surfaces, all speaking the same wire protocol. Install
whichever ones you use:

* **Hosts** run your agents and hold your code: the macOS app, the Windows and
  Linux desktop apps, and the `continuum` CLI. Each one is local-first and
  starts its own daemon — none of them requires another machine.
* **Remotes** steer a host: iPhone, Apple Watch, Android, and the web app.

Every client is free. You pay only for the provider subscriptions you already
have, or for optional [Continuum-hosted inference](/docs/features/hosted-inference).

## Hosts

<Tabs>
  <Tab title="macOS">
    **Status:** stable — this is the flagship client.

    **Requirements**

    * Apple Silicon Mac running **macOS 26 (Tahoe)** or later. The build targets
      macOS 26 and ships arm64-only; Intel Macs and older systems are not
      supported.
    * At least one provider CLI installed and logged in: `claude`, `codex`,
      `cursor-agent`, `agy` (Antigravity), `grok`, or `opencode` — or none at
      all if you use [Continuum-hosted models](/docs/features/hosted-inference).

    **Install**

    1. Download the DMG. [mac.continuumcode.ai](https://mac.continuumcode.ai)
       always redirects to the latest arm64 build; you can also browse
       [every release](https://github.com/Continuumcodeapp/continuum-updates/releases/latest).
    2. Open the DMG and drag `Continuum.app` to your Applications folder.
    3. Launch it from Applications. It appears in the menu bar and opens its
       main window.

    The DMG is Developer ID signed and notarized by Apple (Montauk Analytics
    Inc, team `LRL8MRH6B4`), so Gatekeeper opens it without a security prompt.
    Release builds run inside the App Sandbox.
  </Tab>

  <Tab title="Windows">
    **Status:** beta.

    **Requirements**

    * x64 Windows 10 or 11. (There is no arm64 Windows build.)
    * Provider CLIs on `PATH` for whichever agents you want to run.

    **Install** — download the `.exe` installer from
    [continuumcode.ai/download](https://continuumcode.ai/download) and run it.
    It's an NSIS installer; no admin-only steps beyond the usual installer
    prompt.

    The desktop app is an Electron shell around the same interface the web app
    uses, plus a **bundled daemon** that runs your sessions locally. It is a
    full host, not a remote — you can drive agents on it with no Mac anywhere in
    the picture. See [the desktop app](/docs/surfaces/desktop).

    <Warning>
      Beta builds published so far are not code-signed, so Windows SmartScreen
      warns on first run. Verify you downloaded from continuumcode.ai before
      clicking through.
    </Warning>
  </Tab>

  <Tab title="Linux">
    **Status:** beta.

    **Requirements**

    * x64 or arm64 Linux.
    * Provider CLIs on `PATH` for whichever agents you want to run.

    **Install** — take either package from
    [continuumcode.ai/download](https://continuumcode.ai/download):

    * **`.deb`** (x64 or arm64) — `sudo apt install ./Continuum-<version>-<arch>.deb`
    * **AppImage** (x64 or arm64) — `chmod +x` it and run it directly.

    Same Electron shell and bundled daemon as Windows, so a Linux desktop is a
    first-class host. A headless Linux server is a different thing — enroll that
    as an [execution host](/docs/features/remote-devices) instead.

    <Warning>
      Beta builds published so far are not code-signed.
    </Warning>
  </Tab>

  <Tab title="CLI">
    **Status:** beta.

    `continuum` is the fourth client on the same wire protocol. It runs on
    macOS, Linux, and Windows, x64 and arm64, and drives sessions from a
    terminal, a script, or CI.

    **Install (macOS / Linux)** — no sudo; resolves the latest CLI release,
    verifies its checksums, and installs to `~/.local/bin`:

    ```bash theme={"dark"}
    curl -fsSL https://continuumcode.ai/install-cli.sh | sh
    ```

    To inspect the script first, or to pin a version:

    ```bash theme={"dark"}
    curl -fLO https://continuumcode.ai/install-cli.sh
    sh install-cli.sh --version <version>
    ```

    **Install (Windows PowerShell)** — installs to `%LOCALAPPDATA%\Continuum\bin`,
    no admin rights:

    ```powershell theme={"dark"}
    Invoke-WebRequest https://continuumcode.ai/install-cli.ps1 -OutFile install-cli.ps1
    .\install-cli.ps1
    ```

    Set `CONTINUUM_CLI_INSTALL_DIR` to install somewhere else. See
    [the CLI](/docs/surfaces/cli) for what it can do.

    <Warning>
      CLI archives are **not code-signed** — the release workflow has no
      cross-platform signing credentials yet, and the manifest records that
      explicitly. The SHA-256 check catches accidental corruption, not a
      tampered origin: verify the release origin yourself.
    </Warning>
  </Tab>
</Tabs>

## Remotes

<Tabs>
  <Tab title="iPhone">
    **Status:** stable, on the App Store as
    **[Continuum Console](https://apps.apple.com/app/continuum-console/id6776332528)**.

    Requires iOS 26 or later. Install it, sign in with the same email you used
    on your host, and approve the phone once from the host — see
    [pairing](/docs/pairing).
  </Tab>

  <Tab title="Apple Watch">
    **Status:** stable.

    The Watch app ships inside the iPhone app rather than as a separate App
    Store listing — install Continuum Console on the phone and the Watch app
    installs from there. It never talks to a host directly; the phone relays for
    it.
  </Tab>

  <Tab title="Android">
    **Status:** in testing.

    The Android app (`ai.continuum.mobile`) is built from the same codebase as
    the iPhone app and goes out through Google Play testing tracks; there's no
    public store link on the download page yet. Until there is, the
    [web app](/docs/surfaces/web) gives you the same control plane in a mobile
    browser.
  </Tab>

  <Tab title="Web">
    **Status:** stable. Nothing to install.

    Sign in at [continuumcode.ai/app](https://continuumcode.ai/app) and you get
    the full control plane in a browser tab: Code, Usage, Settings, and org
    administration. Compute still happens on a host — the browser is a remote.
    See [the web app](/docs/surfaces/web).
  </Tab>
</Tabs>

## How each client updates

<Tabs>
  <Tab title="macOS">
    The Mac app keeps itself up to date with **Sparkle 2.9.2**. It reads the
    appcast at
    `https://continuumcodeapp.github.io/continuum-updates/updates/appcast.xml`,
    and every update signature is verified with EdDSA against the app's embedded
    public key.

    Trigger a check from the **Update App** control in the window titlebar, or
    **Check for Updates** in the app menu. That titlebar popover also hosts a
    **Check automatically** toggle for Sparkle's scheduled background checks.

    If Sparkle can't reach the appcast or a download fails, the app falls back to
    opening the
    [latest public release page](https://github.com/Continuumcodeapp/continuum-updates/releases/latest)
    so you can update by hand.

    <Note>
      Mac updates render only in the top-right titlebar popover — there is no
      center-screen update overlay.
    </Note>
  </Tab>

  <Tab title="Windows & Linux">
    The desktop app updates through electron-updater, which reads the release
    metadata published alongside each installer. Point it at your own feed by
    setting `CONTINUUM_UPDATE_FEED_URL` before launch.
  </Tab>

  <Tab title="CLI">
    Automatic updates are **deliberately disabled** until a real release-signing
    trust root exists, so updating is an explicit opt-in:

    ```bash theme={"dark"}
    continuum update --version <version> --check   # inspect that release's manifest
    continuum update --version <version>           # verify SHA-256 and replace the binary
    ```

    Only a writable, user-local executable is replaced; a system-installed copy
    is left alone. Re-running the install script works too.
  </Tab>

  <Tab title="Mobile & web">
    iPhone, Watch, and Android update through their app stores. The web app is
    always current — reload the tab.
  </Tab>
</Tabs>

<Note>
  Continuum installs as `Continuum.app` (or `Continuum` on Windows and Linux).
  The internal codename **Clawdmeter** still appears in on-disk paths — your
  data lives at `~/Library/Application Support/Clawdmeter/` and
  `~/.clawdmeter/`, the URL scheme is `clawdmeter://`, and preferences use the
  `clawdmeter.*` domain. These are stable identifiers, not a different product.
</Note>

## After installing

Install at least one provider CLI and sign in to it — see
[providers](/docs/providers/overview) for what each one needs. Then sign in to
Continuum with your email on every device you own so they find each other:
[pairing](/docs/pairing).