Browse, filter and toggle every HOMEBREW_* environment variable from a fast terminal UI — then write a clean, idempotent block to your profile. Re-running never duplicates a thing.
# features
22 settings across Privacy, Updates, Display, Directories, Tools, Security and Network — discoverable, documented and safe to change.
Browse and edit every Homebrew environment variable, each with its default value shown.
Press / to match by name, variable, category or description as you type.
Writes a clean BEGIN/END block to your profile — re-running never duplicates exports.
Finds the right profile for zsh, bash or fish, preferring the file that already holds your block.
--set, --apply, --dry-run, --list and --json run with no TUI at all.
Export your config to a TOML preset and re-apply it on another machine, forward-compatible by design.
Cycle colour themes with t — brew, midnight, forest, rose, mono — remembered across runs.
Backs up the previous profile to .bak and previews the exact block before writing.
Ships a man page plus bash, zsh and fish completions.
// how it works
Press a and homebrewconfig writes a single marked block to your shell profile. Run it again and only that block changes — the rest of your file is left exactly as it was. Delete the block to remove every managed setting at once.
get started
Needs Rust 1.70+ and a 256-color terminal. Works on macOS and Linux.
brew install vincentlauriat/tap/homebrewconfig — or cargo install homebrewconfig.
Launch homebrewconfig; it auto-detects your shell profile.
Toggle with Space, then press a — review the preview and confirm.
ready?
Free, open-source, scriptable. macOS & Linux, any of zsh / bash / fish.