Installation

Klack currently supports release installs on macOS for Apple silicon and Intel. It has been developed against Slack 4.51.180 and requires Node.js 24 or newer.

Download Klack

The installer selects the release for your Mac, verifies its SHA-256 checksum, and adds a launcher at ~/.local/bin/klack. It does not patch Slack yet.

curl -fsSL https://klack.sh/install | sh

Quit Slack completely

Use Slack → Quit Slack and confirm no other Slack copy is running. Klack intentionally refuses to modify an app while Slack is open.

Inspect before changing anything

~/.local/bin/klack status
 
# Use a separate app path while testing:
~/.local/bin/klack status --app "$HOME/Applications/Slack-Klack.app"

Install the bootstrap

~/.local/bin/klack install
 
# Or install into a disposable copy:
~/.local/bin/klack install --app "$HOME/Applications/Slack-Klack.app"

On the first launch, Klack enables only Plugin Manager and Loaded Indicator, then opens Plugin Manager on its Plugins tab. Choose any additional plugins you want there. Klack saves onboarding completion under ~/.klack and plugin choices in Slack’s profile, so updating or reinstalling Klack does not repeat it or reset your choices.

Update Klack

Quit Slack, then download, verify, and apply the latest Klack release with one command:

klack update

Use the same --app or --no-resign options accepted by klack install when needed. Klack keeps previously downloaded releases and only switches Slack to the new runtime after the verified download succeeds.

Test a pull request build

After the pull request’s CI succeeds, authenticate the GitHub CLI and install its current build:

gh auth login
klack install '#123'

The quotes keep #123 from becoming a shell comment. PR artifacts are retained temporarily and pinned locally by PR number, commit, and CI run. Pull request code is unreviewed and receives the same access as Klack and its plugins, so only install builds you trust.

To download Klack and patch Slack in one command, add --install to the installer:

curl -fsSL https://klack.sh/install | sh -s -- --install

Restore Slack

Quit every Slack copy, then run:

klack uninstall
 
# Match the custom app path if you used one:
klack uninstall --app "$HOME/Applications/Slack-Klack.app"

For protected canonical installs, Klack restores the complete vendor-signed bundle it preserved. Directly writable copies restore the original ASAR but remain ad-hoc signed.

Build from source

Source builds additionally require pnpm. Clone the repository, run its checks, then use pnpm klack in place of the release launcher.

git clone https://github.com/zygimantass/klack.git
cd klack
pnpm install
pnpm check
pnpm test
pnpm klack status

Edit this page on GitHub