Stack Homebrew Tap

This is the official Homebrew tap for the Stack CLI.

Install

Install and trust only the Stack formula:

brew install stack-sh/tap/stack
stack --version

The formula installs the exact archives published by the Stack CLI GitHub Release. It does not rebuild or repackage the binary.

Host	Homebrew support	Stack release target
Apple Silicon macOS on a current Homebrew Tier 1 release	Supported	aarch64-apple-darwin
ARM64 Linux on a current Homebrew Tier 1 host	Supported	aarch64-unknown-linux-gnu
x86_64 Linux with SSSE3 on a current Homebrew Tier 1 host	Supported	x86_64-unknown-linux-gnu
Intel macOS	Unsupported by this formula	—

Stack CLI 0.4.0 archives include shell integration generated by the same binary. The formula installs bash completion to Homebrew's bash_completion path, zsh completion to zsh_completion, fish completion to fish_completion, and stack.1 to man1. It does not edit shell startup files; follow Homebrew's normal completion setup for your shell.

Upgrade and uninstall

brew update
brew upgrade stack-sh/tap/stack

Homebrew owns upgrades for this installation. Do not replace the installed binary with a direct-download or self-update command.

brew uninstall stack-sh/tap/stack

Upgrade and uninstall only change files managed in the Homebrew Cellar. Stack configuration and imported provider icons under $XDG_CONFIG_HOME/stack, or $HOME/.config/stack when XDG_CONFIG_HOME is unset, are intentionally preserved.

Verification and maintenance

The formula test runs stack --version, init, check, and render, and compares every installed completion and manual file with fresh output from the binary. CI additionally verifies the three supported host mappings, formula syntax and style, upstream GitHub attestations, upgrade behavior, uninstall behavior, managed-file removal, and preservation of configuration and icon data.

See Maintaining the formula for the fail-closed update and recovery procedure. Security reports should follow SECURITY.md.