Skip to main content

Install mecatui

Install mecatui, the terminal client, and mecated, the standalone server, on macOS or Linux.

Install with Homebrew​

brew install stacklok/tap/mecatl
mecatui --version

Install with Conda-forge​

If you manage your environment with Conda, install the Mecatl package on Conda-forge with your preferred package manager:

Package managerCommand
Condaconda install -c conda-forge mecatl
Mambamamba install -c conda-forge mecatl
Pixipixi add mecatl

Install from a release archive​

GitHub releases provide darwin and linux archives for amd64 and arm64. Each release also includes checksums, Cosign signature bundles, SBOMs, and build provenance.

Download the archive for your OS and architecture, together with its checksum, signature bundle, and provenance. The example below uses macOS on Apple Silicon; replace the filename for another platform. <VERSION> is the release number used in the asset filename.

Verify the checksum, signature, and provenance before extracting the archive:

shasum -a 256 -c checksums.txt --ignore-missing

cosign verify-blob \
  --bundle mecatl_<VERSION>_darwin_arm64.tar.gz.sigstore.json \
  --certificate-identity-regexp '^https://github.com/stacklok/mecatl/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  mecatl_<VERSION>_darwin_arm64.tar.gz

gh attestation verify mecatl_<VERSION>_darwin_arm64.tar.gz --repo stacklok/mecatl

The Cosign command verifies that a GitHub Actions workflow in the stacklok/mecatl repository signed the archive.

Each archive contains mecatui and mecated at its root, plus the license and README. Extract the verified archive, then check the binaries:

tar -xzf mecatl_<VERSION>_darwin_arm64.tar.gz
./mecatui --version
./mecated --version

Build from source​

A source build requires Go 1.27.2 or later and Task v3. From the repository root, build all executables into bin/:

task build

Next steps​