Movement Labs LogoMovement Docs

Movement CLI

Install and use the Movement CLI

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

Install via Homebrew

Works on macOS ARM64 (M-series), macOS x86_64 (Intel), and Linux x86_64.

brew tap moveindustries/movement
brew install movement

Or directly:

brew install moveindustries/movement/movement

Verify installation:

movement --version

It should return movement 7.4.0.

Windows

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

$Version = "7.4.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

or

movement <subcommand> --help

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