Skip to main content
The CLI is published to npm as @mulerunai/cli. It bundles the right native binary for your platform automatically (macOS arm64/x64, Linux arm64/x64). Node.js 20+ is required.

​
Global install

The recommended setup. The mulerun binary becomes available everywhere on your PATH. 
npm install -g @mulerunai/cli
Verify the install: 
mulerun --version
mulerun --help

​
Run on demand

For one-off use, run through npx or bunx without installing: 
npx -y @mulerunai/cli --version
npx -y @mulerunai/cli login
bunx @mulerunai/cli computer list
The package is cached locally; subsequent invocations reuse the same install.

​
Per-project install

If you want the version pinned to a single repository (recommended for CI): 
npm install --save-dev @mulerunai/cli
Then call it through your package runner: 
npx mulerun computer list

​
Upgrading

The CLI can upgrade itself in place: 
mulerun upgrade           # install latest
mulerun upgrade --check   # only print current vs latest
It will also auto-upgrade in the background on routine commands unless you opt out: 
export MULERUN_NO_AUTO_UPGRADE=1
See the upgrade command page for full details.

​
Uninstall

npm uninstall -g @mulerunai/cli
# or
bun remove -g @mulerunai/cli

​
Next step

Head to Configuration to set your token and any optional proxy or base URL.