Install and update

InstallCopy Anchor Link

curl -fsSL https://layerbeat.com/install.sh | sh

The installer:

• picks the build for your system: macOS (Apple silicon or Intel) or Linux (x86-64 or ARM64; a static build that runs on any distribution, Alpine included);
• downloads it from layerbeat.com over HTTPS and checks it against the published SHA-256 checksums — nothing is installed if the check fails;
• installs layerbeat in ~/.local/bin, with lb as a short alias;
• tells you if ~/.local/bin is not on your PATH, and how to add it.

No curl? wget -qO- https://layerbeat.com/install.sh | sh works the same way.

Check it worked:

layerbeat --version
layerbeat status     # is the Layerbeat API reachable?

OptionsCopy Anchor Link

Set these before sh:

curl -fsSL https://layerbeat.com/install.sh | LAYERBEAT_INSTALL_DIR=/usr/local/bin sh

Read it firstCopy Anchor Link

The script is short and readable. To look before running it:

curl -fsSL https://layerbeat.com/install.sh -o install.sh
less install.sh
sh install.sh

WindowsCopy Anchor Link

Use the Linux build inside WSL: open your WSL terminal and run the same command.

UpdateCopy Anchor Link

Run the installer again. It replaces the binary in place and keeps your sign-in and settings.

curl -fsSL https://layerbeat.com/install.sh | sh

Shell completionCopy Anchor Link

# zsh
mkdir -p ~/.zfunc && layerbeat completion zsh > ~/.zfunc/_layerbeat
# bash
layerbeat completion bash > ~/.local/share/bash-completion/completions/layerbeat
# fish
layerbeat completion fish > ~/.config/fish/completions/layerbeat.fish

For zsh, make sure ~/.zfunc is on your fpath before compinit in ~/.zshrc.

Where files goCopy Anchor Link

XDG_CONFIG_HOME moves the configuration folder.

UninstallCopy Anchor Link

layerbeat logout                       # end the session on Layerbeat's side
rm ~/.local/bin/layerbeat ~/.local/bin/lb
rm -r ~/.config/layerbeat              # forget saved settings and host keys