Install Tuist

Install Tuist

Tuist runs on macOS and Linux. Although you could manually build Tuist from the sources, we recommend using one of the following installation methods to ensure a valid installation.

Mise

If you don’t have Mise installed, follow the getting started guide first. Mise is a recommended alternative to Homebrew if you are a team or organization that needs to ensure deterministic versions of tools across different environments.

Unlike tools like Homebrew, which install and activate a single version of the tool globally, Mise pins a version either globally or scoped to a project. Run mise use to install and activate Tuist:

mise use [email protected]          # Install and pin tuist-x.y.z in the current project
mise use tuist@latest          # Install and pin the latest tuist in the current project
mise use -g [email protected]       # Install and pin tuist-x.y.z as the global default
mise use -g tuist@system       # Use the system's tuist as the global default

If you clone a project that already has a Tuist version pinned in mise.toml, run mise install to install it.

Commands that depend on Xcode (such as `tuist generate`) are not available on Linux, but platform-independent commands like `tuist inspect bundle` work as expected.

Homebrew (macOS only)

You can install Tuist using Homebrew and our formulas:

brew tap tuist/tuist
brew install --formula tuist
brew install --formula [email protected]

curl -fsSL "https://docs.tuist.dev/verify.sh" | bash