Homebrew formulae for Varlatch, the self-host-first secrets and configuration manager.
| Formula | What it installs |
|---|---|
varlatch |
The varlatch CLI, run with Homebrew's Node.js |
varlatch-menubar |
Varlatch for macOS, your sessions in the menu bar, with the CLI |
The menu bar app, with the CLI and Node.js:
brew install varlatch/tap/varlatch varlatch/tap/varlatch-menubar
mkdir -p ~/Applications
ln -sfn "$(brew --prefix)/opt/varlatch-menubar/Varlatch.app" ~/Applications/Varlatch.app
open ~/Applications/Varlatch.appHomebrew loads formulae from a tap like this one only once you trust them,
and installing a formula by its full name trusts it. The app needs the CLI,
so name both; brew install varlatch/tap/varlatch-menubar alone stops at
"Refusing to load formula varlatch/tap/varlatch from untrusted tap". To
trust every formula in this tap instead, run brew trust varlatch/tap
first.
Homebrew builds the app from source on your Mac with Apple's Command Line
Tools (Xcode is not needed), so it opens without a Gatekeeper prompt.
Homebrew cannot write to /Applications; the link in ~/Applications
makes the app show in Finder, Spotlight, and Launchpad, and follows
upgrades. Needs macOS 13 or newer.
Only the CLI:
brew install varlatch/tap/varlatch
varlatch --versionThis installs Node.js from Homebrew when you do not have it yet. The CLI
always runs with Homebrew's node, whatever is first on your PATH.
Then sign in to your server:
varlatch login --server https://varlatch.example.combrew update
brew upgrade varlatch varlatch-menubarThe app (0.2.0 and newer) notices the upgrade and offers to restart into the new version. With 0.1.0 still running, quit it and open it again once.
Homebrew owns the installed files, so a Homebrew CLI refuses
varlatch self-update and points you to brew upgrade varlatch instead.
Turn off Open at login in the app's Settings first, quit it, then:
brew uninstall varlatch-menubar varlatch
rm ~/Applications/Varlatch.app
brew untap varlatch/tapUninstalling leaves your sign-ins in ~/.config/varlatch/. Run
varlatch logout --server <url> first to revoke a credential on its
server, or delete that directory to forget them locally.
bump-varlatch.yml looks for a new
varlatch/varlatch release every
six hours. It checks the release's signature and hash, opens a pull request
that bumps Formula/varlatch.rb, and merges it once CI passes.
- To skip a release, close its pull request. It is not opened again, and the next release gets its own.
- When CI fails, the pull request stays open and the scheduled run fails until a newer release replaces it or someone deals with it.
- After 60 days without a commit, GitHub turns off scheduled workflows in a public repository. Turn it back on in the Actions tab; releases normally keep this from happening.
To bump by hand, or to redo what the workflow does, for version X.Y.Z:
-
Download the release's CLI, checksums, and signature into an empty directory:
gh release download vX.Y.Z --repo varlatch/varlatch \ --pattern 'varlatch-cli-X.Y.Z.cjs' --pattern 'SHA256SUMS' \ --pattern 'SHA256SUMS.sigstore.json'
-
Check the signature on
SHA256SUMS(needscosign), then the file against it:cosign verify-blob SHA256SUMS --bundle SHA256SUMS.sigstore.json \ --certificate-identity "https://github.com/varlatch/varlatch/.github/workflows/release.yml@refs/tags/vX.Y.Z" \ --certificate-oidc-issuer https://token.actions.githubusercontent.com grep ' varlatch-cli-X.Y.Z.cjs$' SHA256SUMS shasum -a 256 varlatch-cli-X.Y.Z.cjs
The two hashes must match.
-
On a branch, set
urlto the new version andsha256to that hash. -
Check it locally, with this checkout as the tap:
brew style varlatch/tap brew audit --strict --online varlatch/tap/varlatch brew reinstall --build-from-source varlatch/tap/varlatch brew test varlatch/tap/varlatch -
Open a pull request. CI runs the same checks on a macOS runner; merge once it passes.
Once CI has passed on the commit and vX.Y.Z is tagged and released in
varlatch/macos-menubar:
-
Hash the tag's source tarball:
curl -fsSL https://github.com/varlatch/macos-menubar/archive/refs/tags/vX.Y.Z.tar.gz | shasum -a 256 -
On a branch, set
urlinFormula/varlatch-menubar.rbto the new tag andsha256to that hash. -
Check it as above (
brew style,brew audit --strict --online,brew reinstall --build-from-source varlatch/tap/varlatch-menubar,brew test), open a pull request, and merge once CI passes.
brew install --HEAD varlatch/tap/varlatch-menubar builds the latest
main instead, for trying unreleased changes.
brew tap clones the tap, so to try changes before they are pushed, put a
link to your checkout in its place:
tap="$(brew --repository)/Library/Taps/varlatch/homebrew-tap"
rm -rf "$tap" && mkdir -p "$(dirname "$tap")" && ln -s "$PWD" "$tap"
brew trust varlatch/tapTo go back to the published tap, remove the link (rm "$tap") and run
brew tap varlatch/tap.
Copyright © 2026 Robotsson. Licensed under the Apache License 2.0; see
LICENSE.