Installation

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

bun add -g @mulerunai/cli

pnpm add -g @mulerunai/cli

yarn global add @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.

Getting Started

Commands

Reference

Global install

Run on demand

Per-project install

Upgrading

Uninstall

Next step

​Global install

​Run on demand

​Per-project install

​Upgrading

​Uninstall

​Next step

Global install

Run on demand

Per-project install

Upgrading

Uninstall

Next step