Skip to content
🍹 An easy, convenient way to automatically update Homebrew.
Branch: master
Clone or download
Latest commit a08ca16 Mar 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd autoupdate: add status command Mar 20, 2019
LICENSE LICENSE: leave end date open-ended Jan 31, 2017 README: update help text Mar 20, 2019


An easy, convenient way to automatically update Homebrew.

This script will run brew update in the background once every 24 hours by default.

brew upgrade and brew cleanup can also be handled automatically but are optional flags. If you have terminal-notifier installed you can also request desktop notifications when this command runs.

Installing this command

Just brew tap domt4/autoupdate.


brew autoupdate --start [interval] [--upgrade] [--cleanup] [--enable-notification]:
  Start autoupdating either once every interval hours or once every 24 hours.
  Please note the interval has to be passed in seconds, so 12 hours would be:
    brew autoupdate --start 43200.

  If --upgrade is specified, autoupdate will also upgrade your installed
  formulae. If the Caskroom exists locally Casks will be upgraded as well.

  If --cleanup is specified, autoupdate will also automatically clean
  brew's cache and logs.

  If --enable-notification is specified, autoupdate will send a notification
  when the autoupdate process has finished successfully, if terminal-notifier
  is installed & found.

 autoupdate --stop:
  Stop autoupdating, but retain plist & logs.

 autoupdate --delete:
  Cancel the autoupdate, delete the plist and logs.

 autoupdate --status:
  Prints the current status of this tool.

 autoupdate --version:
  Output this tool's current version.

This Vs brew's built-in autoupdate mechanism

This command mostly exists to ensure Homebrew is updated regardless of whether you invoke brew or not, which is the primary difference from the autoupdate mechanism built into brew, the latter requiring a user to explicitly run any of brew install, brew tap or brew upgrade.

If you run brew commands regularly yourself, you may wish to consider using the built-in autoupdate mechanism, which can be instructed to autoupdate less often or disabled entirely. If you wish to update every 24 hours using the built-in autoupdate mechanism set this in your environment:


or if you wish to disable the built-in autoupdate mechanism entirely:


Please note that Homebrew themselves slightly frown upon people disabling the built-in autoupdate mechanism.


Code is under the BSD 2 Clause (NetBSD) license.

You can’t perform that action at this time.