Install¶

Mac¶

SBT runs on Macs with Apple silicon.

1. Download the newest Switchbard-<version>-macos-arm64.dmg from releases.
2. Open it and drag Switchbard to Applications.
3. Open Switchbard from Applications.

The app is signed and notarized by Apple, so it opens without a warning. It updates itself: it checks for a new version every four hours, downloads it in the background, and installs it when you click Update ready or next quit.

The app brings everything it needs, including the sbt command. On first open it offers to set up what your Mac is missing; see Get started.

Linux¶

There is no Linux download yet. You can build the sbt command and the desktop window from source if you have access to the source repository. You need Git, a C compiler, tmux, rustup and, for the window, Node 24.

git clone https://github.com/Menantic-Creek-Capital/switchbard.git
cd switchbard
cargo build --locked --release -p switchbard-tui
mkdir -p ~/.local/bin
install -m 755 target/release/sbt ~/.local/bin/sbt
sbt --version

Make sure ~/.local/bin is on your PATH. That is the whole terminal app. For the window, run npm ci and then npm run app in web/desktop; the repository's docs/INSTALL-LINUX.md lists the system libraries it needs.

Optional extras¶

SBT never asks for your GitHub password and keeps no GitHub token of its own. It uses the gh sign-in you already have.

Uninstall¶

Drag Switchbard from Applications to the Bin. Your tasks and settings stay in ~/.switchbard; delete that folder too if you want them gone. See Your data.