init

• packages installation

• tap

• cask

• backup and restore

packages installation

[!TIP|label:build from local source]

• encounter the branch name issue or submodule fetch issue in --HEAD, can modify manaully and execute :

$ brew install --HEAD <formula> --build-from-source -v --debug

# --- utils ---
$ brew install --HEAD bash-completion@2 file-formula mtr mas
$ brew install util-linux inetutils coreutils moreutils bash less proctools pstree vnstat ncdu ipcalc htop glances lsof trash
$ brew install gawk grep findutils gnu-which gnu-getopt gnu-sed gnu-tar gnu-indent gnutls iproute2mac ifstat stow netcat nmap
$ brew install dos2unix openldap
$ brew install tmux corkscrew telnet
$ brew install figlet
$ brew install --HEAD toilet
$ brew install colordiff diffutils wdiff difftastic
$ brew install --HEAD diff-so-fancy highlight
$ brew install ansifilter                         # decolorize
$ brew install gnu-tar gzip carlocab/personal/unrar
$ brew install zip unzip                          # info-zip
$ brew install --HEAD rename whois watch wget curl
$ brew install --HEAD hexyl                       # a hex viewer for the terminal
$ brew install lynx                               # text-based web browser
$ brew install fdupes                             # find duplicate files
$ brew install --HEAd pandoc poppler fontforge
$ brew install --HEAD mupdf-tools                 # pdf viewer
$ brew install pdfcpu &&                          # extract font from pdf
  mkdir -p "$HOME/Library/Application Support/pdfcpu"
$ brew install create-dmg
$ brew install imagemagick
$ sudo gem install iStats -n /usr/local/bin       # requires ruby to be installed
$ brew install hfsutils p7zip                     # for dmg

$ brew install --HEAD pass
$ brew install pass-otp
$ brew install --HEAD pinentry-mac                # for alfred workflow

# --- editor ---
## nvim
$ brew install --HEAD utf8proc
$ brew install --HEAD neovim
$ brew install --cask vimr
$ python3 -m pip install jedi
$ python3 -m pip install --upgrade pynvim
$ GEM_HOME="$HOME/.gem" gem install neovim --user-install
$ brew install --HEAD viu                         # imgcat
$ brew install chafa
## macvim/vim
$ brew install pcre2 gettext libtool              # for build vim from source
$ brew install --HEAD macvim                      # using `--HEAD` to prevent 32bit vim + 64bit python
$ sudo cp -r $(brew --prefix macvim)/MacVim.app /Applications
## vscode
$ brew install --cask visual-studio-code
# or link to cmd via
$ sudo ln -sf '/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code' /usr/local/bin/code

# --- dev tools ---
$ brew install --HEAD ruby
# nvm for gitbook install: nvm install 12
$ brew install openjdk gradle nvm mongosh groovy
$ brew install --HEAD gradle-completion open-completion docker-completion gem-completion
$ brew install kubecolor
$ brew install --HEAD kubectl jfrog-cli jq
$ brew install --HEAD git-flow git-extras
$ brew install --HEAD fzf fzy bat ack ag rg gum fd
$ brew install mkdocs                             # markdown docs, usage: `mkdocs build -d site -s`
$ curl -o "$HOME/.local/bin/cht.sh" -fsSL 'https://cht.sh/:cht.sh' && chmod +x "$HOME/.local/bin/cht.sh"
$ brew install --HEAD cheat
$ brew install hashicorp/tap/vault

# --- pipx and tools ---
$ python3 -m pip install --user -U pipx
$ python3 -m pipx ensurepath
$ python3 -m pipx install poetry                  # python packaging and dependency management made easy
$ python3 -m pipx install pre-commit
$ python3 -m pipx install commitizen              # optional

# --- npm packages ---
$ brew install --HEAD tlrc
$ npm i -g tldr                                   # or $ python3 -m pip install tldr
$ npm i -g gnomon
$ npm i -g tabset
$ npm i -g doctoc
$ npm i -g git-stats
$ npm i -g svgexport
$ npm i -g iterm2-tab-set
$ npm i -g neovim
$ npm i -g npm-completion
# - optional -
$ sudo ln -sf $(npm get prefix)/bin/* /usr/local/bin/

# --- lint ---
$ brew install --HEAD shellcheck yamllint yamlfmt
$ npm i -g npm-groovy-lint && sudo ln -sf $(npm get prefix)/bin/npm-groovy-lint /usr/local/bin/npm-groovy-lint
$ npm i -g @commitlint/{cli,config-conventional}  # for commitlint
$ npm i -g css-validator                          # for css validation
$ brew install hadolint                           # for dockerfile
$ brew install stylelint                          # for css
$ brew install jsonlint ansible-lint
$ brew install vint                               # vim script language lint
$ brew install --HEAD eslint
$ brew install --HEAD shfmt                       # autoformat shell script source code
# optional
$ brew install actionlint                         # for github action
$ brew install libxml2                            # for xmllint

# --- cask ---
$ brew install --cask keycastr
$ brew install --cask fliqlo                      # flip clock screensaver

# --- tap ---
$ brew tap hashicorp/tap
$ brew tap homebrew/command-not-found             # brew which-formula && brew which-update
$ brew tap vitorgalvao/tiny-scripts
$ brew tap buo/cask-upgrade                       # brew cu

# check tap info
$ brew tap-info vitorgalvao/tiny-scripts --json | jq -r .[].formula_names

# --- for fun ---
$ brew install pv dialog zenity
$ brew install fortune

tap

$ brew tap
buo/cask-upgrade
carlocab/personal
hashicorp/tap
homebrew/command-not-found
vitorgalvao/tiny-scripts

cask

       Cask                  Current       Latest        A/U    Result
 1/19  alfred                5.6           5.6            Y   [   OK   ]
 2/19  baiduinput            6.0.3.66      6.0.3.66           [   OK   ]
 3/19  beyond-compare        5.0.7.30840   5.0.7.30840    Y   [   OK   ]
 4/19  chatbox               1.12.0        1.12.0         Y   [   OK   ]
 5/19  cherry-studio         1.2.7         1.2.7          Y   [   OK   ]
 6/19  cleanmymac            5.0.7         5.0.7          Y   [   OK   ]
 7/19  cursor                0.49.5        0.49.5         Y   [   OK   ]
 8/19  dash                  7.3.5         7.3.5          Y   [   OK   ]
 9/19  google-chrome@canary  137.0.7145.0  137.0.7145.0   Y   [   OK   ]
10/19  istat-menus           7.10.2        7.10.2         Y   [   OK   ]
11/19  jiggler               1.9           1.9                [   OK   ]
12/19  keycastr              0.10.3        0.10.3         Y   [   OK   ]
13/19  macvim                181           181            Y   [   OK   ]
14/19  moom                  4.1.3         4.1.3          Y   [   OK   ]
15/19  paintbrush            2.6.0         2.6.0              [   OK   ]
16/19  shottr                1.8.1         1.8.1          Y   [   OK   ]
17/19  snipaste              2.10.6        2.10.6         Y   [   OK   ]
18/19  vimr                  0.52.0        0.52.0         Y   [   OK   ]
19/19  wechat                4.0.3.93      4.0.3.93       Y   [   OK   ]

       Cask                  Current                       Latest                        A/U    Result
 1/21  alfred                5.6.2                         5.6.2                          Y   [   OK   ]
 2/21  baiduinput            6.0.3.66                      6.0.3.66                           [   OK   ]
 3/21  beyond-compare        5.0.7.30840                   5.0.7.30840                    Y   [   OK   ]
 4/21  chatbox               1.12.3                        1.12.3                         Y   [   OK   ]
 5/21  cherry-studio         1.3.3                         1.3.3                          Y   [   OK   ]
 6/21  cleanmymac            5.0.9                         5.0.9                          Y   [   OK   ]
 7/21  cursor                0.50.4                        0.50.4                         Y   [   OK   ]
 8/21  dash                  7.3.5                         7.3.5                          Y   [   OK   ]
 9/21  google-chrome@canary  138.0.7180.0                  138.0.7180.0                   Y   [   OK   ]
10/21  istat-menus           7.10.2                        7.10.2                         Y   [   OK   ]
11/21  jiggler               1.9                           1.9                                [   OK   ]
12/21  keycastr              0.10.3                        0.10.3                         Y   [   OK   ]
13/21  macvim                181                           181                            Y   [   OK   ]
14/21  moom                  4.2.0                         4.2.0                          Y   [   OK   ]
15/21  paintbrush            2.6.0                         2.6.0                              [   OK   ]
16/21  shottr                1.8.1                         1.8.1                          Y   [   OK   ]
17/21  sip                   3.6.2                         3.6.2                          Y   [   OK   ]
18/21  snipaste              2.10.6                        2.10.6                         Y   [   OK   ]
19/21  vimr                  0.53.0                        0.53.0                         Y   [   OK   ]
20/21  warp                  0.2025.05.07.08.12.stable_02  0.2025.05.07.08.12.stable_02   Y   [   OK   ]
21/21  wechat                4.0.3.93                      4.0.3.93                       Y   [   OK   ]

backup and restore

# backup
$ brew bundle dump --file=./brew.backup.all.txt --describe

# restore
$ brew bundle --file=./brew.backup.all.txt

# [BE CAREFUL] cleanup not been listed in brew.backup.all.txt
$ brew bundle cleanup --file=./brew.backup.all.txt