Hometown is available on Homebrew. Run

brew install olets/tap/hometown-prompt

and follow the post-install instructions logged to the terminal.


You can install Hometown with a zsh plugin manager. Each has their own way of doing things. See your package manager's documentation or the zsh plugin manager plugin installation procedures gist.

After adding the plugin to the manager, it will be available in all new terminals. To use it in an already-open terminal, restart zsh in that terminal:

exec zsh


Either clone this repo and add source path/to/hometown.zsh-theme to your .zshrc, or

  1. Download the latest Hometown Prompt binary
  2. Put the file hometown.zsh-theme in a directory in your PATH

Then restart zsh:

exec zsh