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#

Info

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:

bash

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.

Linux Support

On Linux, Tuist is available exclusively via Mise. 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:

bash

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

Verifying The Authenticity Of The Binaries

You can verify that your installation's binaries have been built by us by running the following command, which checks if the certificate's team is U6LC622NKF:

bash

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