Repository: Homebrew/homebrew-cask

Stars: 21960

CLAUDE.md Copy Chapter

@AGENTS.md

README.md Copy Chapter

Homebrew Cask

_“To install, drag this icon…” no more!_

Homebrew Cask extends Homebrew and brings its elegance, simplicity, and speed to the installation and management of GUI macOS applications such as Visual Studio Code and Google Chrome.

We do this by providing a friendly CLI workflow for the administration of macOS applications distributed as binaries.


Let’s try it! Copy Chapter

To start using Homebrew Cask, you just need Homebrew installed.

<div align="center">
<img src="./doc/readme/readme-gif.gif" width="450" alt="Installing and uninstalling Alfred (animated gif)">
</div>

Slower, now:

% brew install alfred
==> Fetching downloads for: alfred 
✔︎ Cask alfred (5.7.2,2312)                                           Verified      5.6MB/  5.6MB
==> Installing Cask alfred
==> Moving App 'Alfred 5.app' to '/Applications/Alfred 5.app'
🍺  alfred was successfully installed!

And there we have it. An application installed with one quick command: no clicking, no dragging, no dropping.

Learn More Copy Chapter

* Find basic documentation on using Homebrew Cask in USAGE.md.
* Want to contribute a cask? Awesome! See CONTRIBUTING.md.
* More project-related details and discussion are available in the documentation.

Reporting Bugs Copy Chapter

If you ignore this guide, your issue may be closed without review

Before reporting a bug, run brew update-reset && brew update and try your command again. This is a fix-all that will reset the state of all your taps, ensuring the problem isn’t an outdated setup on your side.

If your issue persists, search for it before opening a new one. If you find an open issue and have any new information, add it in a comment. If you find a closed issue, try the solutions there.

If the issue is still not solved, see the guides for common problems:

* Examples of common errors and their solutions
* curl error
* Permission denied error
* Checksum does not match error
* source is not there error
* wrong number of arguments error
* App isn’t included in upgrade
* The app can’t be opened because it is from an unidentified developer
* My problem isn’t listed

Requests Copy Chapter

* Issues requesting new casks will be closed. If you want a cask added to the main repositories, submit a pull request.
* For a feature request, use this template.

Questions? Wanna chat? Copy Chapter

We’re really rather friendly! Here are the best places to talk about the project:

* Open an issue.
* Join us on GitHub discussions (forum).

License Copy Chapter

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