bateri runs on macOS 14 or later, on Apple silicon. It is free software, under the GPL-3.0.
Download
Download bateri.dmg, open it and drag bateri into Applications. The app is signed with a Developer ID and notarized by Apple, so it opens without a warning.
Homebrew
brew install bateri/tap/bateri
Updates
bateri checks for a new version once a day and asks before installing it; you can also check any time with bateri ▸ Check for Updates…. The check goes straight to bateri’s releases on GitHub: there is no update server of its own, and nothing but the version check is sent. Every update is signed with bateri’s EdDSA key and verified before it is installed.
Your shell
bateri sets up zsh, fish and bash (4.4 or newer) by itself when it starts a shell. It never writes to your dotfiles: the integration is loaded through ZDOTDIR (zsh), XDG_DATA_DIRS (fish) or ENV (bash), and your own startup files run as usual. This is what enables command blocks, the input dock and the ssh status bar.
If you prefer to keep your own prompt and edit on the grid like a classic terminal, set integration = "blocks" (blocks and marks stay, the dock goes) or "off" in the [shell] section of your settings:
# ~/.config/bateri/settings.toml
[shell]
integration = "blocks"
Settings
Your settings live in one file, ~/.config/bateri/settings.toml, and bateri ▸ Settings… (⌘,) opens a window for them. A change takes effect the moment you save, whether you made it in the window or in the file. If the file doesn’t exist, everything runs with its default. Settings lists every key.