Skip to main content
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.
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.
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.

​
Verify the Installation

After installing, open a new terminal and run:
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:
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. It restores your coding agents to their original configuration, stops the gateway, and wipes every trace of CMX on Linux, macOS, or Windows.
After installing, run cmx setup to sign in with your free account and connect your coding agent. See the Quick Start guide for a full walkthrough.

​
Nightly Builds

Prefer to test unreleased fixes? Install the @nightly tag via npm or pnpm, or grab a prerelease from the releases page. Nightly builds may contain breaking changes, so stick with stable for production work.