Movement CLI

Movement CLI supports Aptos Move natively. Here are the instructions to install and use movement CLI.

Having Rust and Cargo is a prerequisite to installing the movement CLI. The easiest way to get Cargo is to install the current stable release of Rust by using rustup. Installing Rust using rustup will also install cargo.

On Linux and macOS systems, this is done as follows:

curl https://sh.rustup.rs -sSf | sh

Quick Install Movement Precompiled Binaries

As Movement transitions to supporting Move 2, we are temporarily supporting separate CLIs for Movement mainnet and testnet.

Mainnet

For ARM64 processors (newer Macs, for example M-series chips):

curl -LO https://github.com/movementlabsxyz/homebrew-movement-cli/releases/download/bypass-homebrew/movement-macos-arm64.tar.gz && mkdir -p temp_extract && tar -xzf movement-macos-arm64.tar.gz -C temp_extract && chmod +x temp_extract/movement && sudo mv temp_extract/movement /usr/local/bin/movement && rm -rf temp_extract

For Macs running x86_64 processors (e.g. Intel chips):

curl -LO https://github.com/movementlabsxyz/homebrew-movement-cli/releases/download/bypass-homebrew/movement-macos-x86_64.tar.gz && mkdir -p temp_extract && tar -xzf movement-macos-x86_64.tar.gz -C temp_extract && chmod +x temp_extract/movement && sudo mv temp_extract/movement /usr/local/bin/movement && rm -rf temp_extract

In about under 10 seconds, your install should be done. You can verify by running:

movement --version

It should return movement 7.4.0.

Testnet

Same instructions as mainnet but use the commands below for Move 2 support.

For ARM64 processors (newer Macs, for example M-series chips):

curl -LO https://github.com/movementlabsxyz/homebrew-movement-cli/releases/download/bypass-homebrew/movement-move2-testnet-macos-arm64.tar.gz && mkdir -p temp_extract && tar -xzf movement-move2-testnet-macos-arm64.tar.gz -C temp_extract && chmod +x temp_extract/movement && sudo mv temp_extract/movement /usr/local/bin/movement && rm -rf temp_extract

For Macs running x86_64 processors (e.g. Intel chips):

curl -LO https://github.com/movementlabsxyz/homebrew-movement-cli/releases/download/bypass-homebrew/movement-move2-testnet-macos-x86_64.tar.gz && mkdir -p temp_extract && tar -xzf movement-move2-testnet-macos-x86_64.tar.gz -C temp_extract && chmod +x temp_extract/movement && sudo mv temp_extract/movement /usr/local/bin/movement && rm -rf temp_extract

Windows

For Windows users, we recommend installing the Aptos CLI. Movement CLI commands are fully compatible with Aptos CLI.

$Version = "3.5.0"
$ZipUrl = "https://github.com/aptos-labs/aptos-core/releases/download/aptos-cli-v$Version/aptos-cli-$Version-Windows-x86_64.zip"
$InstallDir = "$env:USERPROFILE\.aptoscli\bin"
$ZipPath = "$env:TEMP\aptos-cli.zip"

Invoke-WebRequest -Uri $ZipUrl -OutFile $ZipPath
New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
Expand-Archive -Path $ZipPath -DestinationPath $InstallDir -Force

# Set PATH
$CurrentPath = [System.Environment]::GetEnvironmentVariable("Path", "User")
if ($CurrentPath -notlike "*$InstallDir*") {
setx PATH "$CurrentPath;$InstallDir"
Write-Host "`n✅ PATH updated. Please restart your terminal before running 'aptos'."
} else {
Write-Host "`n✅ PATH already configured."
}

Install Movement CLI Manually

When developing on Movement, it is recommended to use the movement CLI.

Binary Install

git clone https://github.com/movementlabsxyz/aptos-core/ && cd aptos-core

cargo build -p movement

Copy movement into your bin or add it to your PATH depending on your system config.

For example, to copy movement to bin on Mac or Linux:

sudo cp target/debug/movement /usr/local/bin/

Use Movement CLI

Movement CLI commands are analogous to those of Aptos CLI. Simply replace aptos with movement.

So aptos move build becomes movement move build.

For help within the CLI tool:

movement --help

movement <subcommand> --help

Developers who would like to contribute or read the source code, please see the Movement CLI crate.