Skip to main content
The autosana CLI connects local simulators, emulators, physical devices, and dev servers to Autosana so you can run flows against a build on your own machine. It also validates your code-managed flow files offline before you push (autosana flows validate).

​
Quick install

The fastest way — installs uv if it’s missing, then the CLI. Zero prerequisites: 
curl -fsSL https://get.autosana.ai | sh
Re-run it any time to upgrade.

​
Other install methods

On a Mac and already using Homebrew? brew install autosana/tap/autosana is the most familiar path.
Homebrew: 
brew install autosana/tap/autosana
pipx: 
pipx install autosana
uv: 
uv tool install autosana
pip (into an environment you manage): 
pip install "autosana>=0.8.0"
The autosana flows commands (validate/export) require version 0.8.0 or newer. Older installs won’t have them.

​
Verify

autosana --version
If autosana isn’t found after installing with uv, add uv’s tool directory to your PATH and restart your shell: 
uv tool update-shell

​
Set up prerequisites

Local device testing needs Node.js, Appium, and a tunnel. The CLI installs and checks them for you: 
autosana doctor        # report what's missing
autosana doctor --fix  # auto-install Node.js + Appium + cloudflared

​
Upgrading

curl -fsSL https://get.autosana.ai | sh   # or:
uv tool upgrade autosana
pipx upgrade autosana
brew upgrade autosana

​
Next steps