Install

Install metais

metais is one static binary with no dependencies.

WhoRoute
macOSHomebrew: brew install kottera/tap/metais
Linux, or a Mac without HomebrewThe install script: curl -fsSL https://metais.org/install.sh | sh
Go usersGo: go install metais.org/metais/cmd/metais@latest
AnyoneThe release's archives and SHA256SUMS

Every route but go install installs the same bytes: the archives of the release on GitHub. go install builds the same version from the module.

Homebrew

brew install kottera/tap/metais

The install script

curl -fsSL https://metais.org/install.sh | sh

install.sh is a short POSIX shell script; read it before you run it. It runs on macOS and Linux, on amd64 and arm64. It downloads this machine's archive and SHA256SUMS from the GitHub release, and refuses to install unless the archive's SHA-256 is the one SHA256SUMS lists for it.

It installs metais into ~/.local/bin, or into the directory METAIS_INSTALL_DIR names, with no sudo. It never edits your shell's startup files: when the directory is not on your PATH, it says so and prints the line to add to one.

curl -fsSL https://metais.org/install.sh | METAIS_INSTALL_DIR=/opt/metais/bin sh

Without METAIS_VERSION, it installs the latest release that is not a prerelease. METAIS_VERSION pins a version, with or without its leading v:

curl -fsSL https://metais.org/install.sh | METAIS_VERSION=1.0.0 sh

Go

go install metais.org/metais/cmd/metais@latest

The release's archives

metais 1.0.0, from the release v1.0.0, and its SHA256SUMS:

ArchiveSHA-256
metais_1.0.0_darwin_amd64.tar.gz0d831c91c79b3a851f55e4da3196a1340ac0e7af92d3cf4d7289dbc59ac868ee
metais_1.0.0_darwin_arm64.tar.gzda0d818b072cb8bd580a2e4b3696fe9bacf91a157abf1a5e42133c4599b34df5
metais_1.0.0_linux_amd64.tar.gzfd7481dcdc7d93dfbe2f303e7959e7d7458a83ecea70073dfe19d6f413d677e9
metais_1.0.0_linux_arm64.tar.gz6dc7b1cd5e10610e3e32e950a79164d2f397873168865ce94f454fd2bbc4b70e

Verify the archive against SHA256SUMS in the directory that holds both, on Linux and on macOS:

sha256sum --check --ignore-missing SHA256SUMS
shasum -a 256 --check --ignore-missing SHA256SUMS

Each prints the archive's name and OK. Then unpack metais into a directory on your PATH:

tar -xzf metais_*_linux_amd64.tar.gz metais
mkdir -p ~/.local/bin
mv metais ~/.local/bin/

On macOS, a binary downloaded with a browser carries the quarantine attribute, and Gatekeeper refuses to run it. Remove it after you have verified the archive:

xattr -d com.apple.quarantine ~/.local/bin/metais

Next

metais version
metais skill

metais version prints the version you installed. metais skill, run at the top of a project, gives the project's coding agent the skill that teaches it metais.