Skip to content

Install the CLI

If you followed Getting started and installed the Claude plugin, you may not need this page — the plugin does not include the CLI itself, but Claude may already have installed it for you. Check in your terminal:

Terminal window
adsk-experiment version

If that prints a version, you are ready — go to CLI commands. If not, pick an install method below.

If you use Homebrew and have not set up the Autodesk tap before, do this once:

  1. Create a Classic personal access token at git.autodesk.com/settings/tokens with the repo scope.
  2. Add the tap and install:
Terminal window
echo 'export HOMEBREW_AUTODESK_GHE_TOKEN="<your token>"' >> ~/.zshrc # ~/.bashrc if you're not on zsh
source ~/.zshrc
brew tap iaas/tap "https://$HOMEBREW_AUTODESK_GHE_TOKEN@git.autodesk.com/iaas/homebrew-tap.git"
brew install adsk-experiment

If you already tapped iaas/tap for another Autodesk tool (such as Kiln), skip straight to brew install adsk-experiment.

Upgrade:

Terminal window
brew upgrade adsk-experiment

Uninstall:

Terminal window
brew uninstall adsk-experiment

Uninstalling removes the binary only. Your settings and sign-in token stay in ~/.adsk-experiment-ee until you delete that folder yourself.

Terminal window
r='https://artifactory.dev.adskengineer.net/artifactory'
n=$(curl -fsSL "$r/api/search/artifact?name=adsk-experiment-v*-install.sh&repos=CRUCIBLE-generic" \
| grep -o '"uri" *: *"[^"]*"' | sed -E 's/.*"(.*)"$/\1/; s#.*/##' \
| grep -E '^adsk-experiment-v[0-9]+\.[0-9]+\.[0-9]+-install\.sh$' \
| sed -E 's/^adsk-experiment-v([0-9]+)\.([0-9]+)\.([0-9]+)-install\.sh$/\1.\2.\3 &/' \
| sort -t. -k1,1n -k2,2n -k3,3n | tail -1 | cut -d' ' -f2)
[ -n "$n" ] || { echo "could not resolve an adsk-experiment release" >&2; exit 1; }
curl -fsSL "$r/CRUCIBLE-generic/$n" | sh

Restart your terminal afterwards, or run source ~/.adsk-experiment/env.

Upgrade: re-run the one-liner above, or run sh ~/.adsk-experiment/install.sh.

Uninstall:

Terminal window
sh ~/.adsk-experiment/install.sh --uninstall

Add --force to skip confirmation prompts.

Run this in PowerShell:

Terminal window
$r='https://artifactory.dev.adskengineer.net/artifactory'
$n=(irm "$r/api/search/artifact?name=adsk-experiment-v*-install.ps1&repos=CRUCIBLE-generic").results |
%{ ($_.uri -split '/')[-1] } |
?{ $_ -match '^adsk-experiment-v(\d+)\.(\d+)\.(\d+)-install\.ps1$' } |
sort { [version]($_ -replace '^adsk-experiment-v(.+)-install\.ps1$','$1') } |
select -Last 1
if (-not $n) { throw "could not resolve an adsk-experiment release" }
irm "$r/CRUCIBLE-generic/$n" | iex

Restart your terminal afterwards.

Upgrade: re-run the one-liner above, or run the copy at %LOCALAPPDATA%\adsk-experiment\install.ps1.

Uninstall:

Terminal window
powershell -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\adsk-experiment\install.ps1" -Uninstall

Add -Force to skip confirmation prompts.

If the install fails with a PowerShell parser error mentioning an unexpected token, re-run the bootstrap one-liner — you likely fetched an older installer script.

Once installed, you can also upgrade with adsk-experiment update — see CLI commands.

If something isn’t working, start with ! adsk-experiment doctor or ask Claude Code. Visit CLI commands for useful commands.

For additional help, join #experimental-environments on Slack.