> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compressi.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Install CMX on Linux, macOS, or Windows — All Methods

> All ways to install CMX: npm, pnpm, curl installer, and standalone binaries for Linux, macOS, and Windows on x64 and ARM64. No subscription required.

CMX supports Windows, macOS, and Linux on both x64 and ARM64. Choose the install method that fits your setup: a package manager if you already have Node.js, or a standalone binary if you prefer no runtime dependency.

## Package Manager Install

Package manager installs require **Node.js 18 or later** and either npm or pnpm. This method keeps CMX on your existing update workflow.

<CodeGroup>
  ```bash npm theme={null}
  npm install --global @compressius/cmx
  ```

  ```bash pnpm theme={null}
  pnpm add --global @compressius/cmx
  ```
</CodeGroup>

Each package downloads the matching release binary for your platform and verifies its SHA-256 checksum before exposing the `cmx` command.

## Standalone Installer (No Node.js Required)

Use the standalone installer if you don't have Node.js or prefer a self-contained binary. The installer downloads the correct binary for your platform, verifies its checksum, and places it on your PATH.

<Tabs>
  <Tab title="Linux">
    ```sh theme={null}
    curl -sSfL https://compressi.us/install.sh | sh
    ```

    The script detects your architecture (x86\_64 or arm64), downloads the matching binary, verifies the SHA-256 checksum, and installs to `/usr/local/bin` or `~/.local/bin` depending on write permissions. After installation, `cmx setup` runs automatically unless you pass `CMX_SKIP_START=1`.
  </Tab>

  <Tab title="Mac">
    ```sh theme={null}
    curl -sSfL https://compressi.us/install.sh | sh
    ```

    The script detects Intel or Apple Silicon, downloads the matching binary, verifies the SHA-256 checksum, and installs to `/usr/local/bin` or `~/.local/bin`. After installation, `cmx setup` runs automatically unless you pass `CMX_SKIP_START=1`.
  </Tab>

  <Tab title="Windows">
    Run the following command in a PowerShell terminal:

    ```powershell theme={null}
    iwr -useb https://compressi.us/install.ps1 | iex
    ```

    The script downloads the binary for your architecture, verifies its SHA-256 checksum, installs to `%LOCALAPPDATA%\CMX\bin`, adds that directory to your user PATH, and creates a Start menu shortcut. After installation, `cmx setup` runs automatically.

    Prefer a graphical installer? Download the `.exe` directly:

    * [Windows x64 installer](https://compressi.us/downloads/cmx-setup-windows-amd64.exe) for Intel and AMD PCs
    * [Windows ARM64 installer](https://compressi.us/downloads/cmx-setup-windows-arm64.exe) for Windows on ARM
  </Tab>
</Tabs>

## Verify the Installation

After installing, open a new terminal and run:

```bash theme={null}
cmx --version
```

If the command is not found, the install directory may not be on your PATH yet. Open a new terminal window first, your shell may not have picked up PATH changes from the installer. If it's still missing, add the install directory manually:

```bash theme={null}
# Example for ~/.local/bin (Linux / macOS)
export PATH="$HOME/.local/bin:$PATH"
```

Add that line to your `~/.bashrc` or `~/.zshrc` to make it permanent.

## Uninstall

To remove CMX, follow the platform-specific full-purge guide in [Uninstall](/uninstall). It restores your coding agents to their original configuration, stops the gateway, and wipes every trace of CMX on Linux, macOS, or Windows.

<Note>
  After installing, run `cmx setup` to sign in with your free account and connect your coding agent. See the [Quick Start](/quickstart) guide for a full walkthrough.
</Note>

## Nightly Builds

Prefer to test unreleased fixes? Install the `@nightly` tag via npm or pnpm, or grab a prerelease from the [releases page](https://github.com/compressius/cmx/releases). Nightly builds may contain breaking changes, so stick with stable for production work.


## Related topics

- [Uninstall and Purge CMX on Linux, macOS, and Windows](/uninstall.md)
- [CMX Quick Start: Install, Connect, and Save Tokens](/quickstart.md)
- [CMX CLI Reference: All Commands, Flags, and Examples](/cli-reference.md)