DEV Community

Cover image for Introducing brew-coffee - One Command Dev Environment Setup
Naveen Thurimerla
Naveen Thurimerla

Posted on

Introducing brew-coffee - One Command Dev Environment Setup

#homebrew #devops #development #developer

If you’ve ever onboarded to a new project, switched laptops, or tried spinning up a fresh dev setup, you probably know the pain inconsistent environments, missing packages, broken dependencies, endless brew installs…

So I built brew-coffee a lightweight, modular, Homebrew-powered CLI that turns environment setup into a 10-second, zero-stress, fully reproducible process.

☕ What is brew-coffee?

brew-coffee is a simple CLI wrapper around Homebrew bundles. It helps you:

  • Install entire developer environments with a single command
  • Use curated bundles for programming languages, cloud providers, and dev tools
  • Reuse modular Brewfiles for clean organization
  • Check, clean, or list bundles easily
  • Keep your setup consistent across machines or teams

🚀 Getting Started

Clone the repo 

git clone https://github.com/n4en/brew-coffee.git
cd brew-coffee
Enter fullscreen mode Exit fullscreen mode

Make the script executable 

chmod +x ./coffee.sh
Enter fullscreen mode Exit fullscreen mode

☕ Usage Guide

📜 List Bundles 

./coffee.sh list
Enter fullscreen mode Exit fullscreen mode

Example:

 - python
 - nodejs
 - aws
 - azure
 - gcp
 - k8s
 - infra
 - dev
Enter fullscreen mode Exit fullscreen mode

▶️ Install Bundles

Single bundle:

./coffee.sh install python
Enter fullscreen mode Exit fullscreen mode

Multiple bundles:

./coffee.sh install python nodejs aws
Enter fullscreen mode Exit fullscreen mode

Install everything:

./coffee.sh install
Enter fullscreen mode Exit fullscreen mode

🔍 Check Installation Status

Check one bundle:

./coffee.sh check aws
Enter fullscreen mode Exit fullscreen mode

Check all:

./coffee.sh check
Enter fullscreen mode Exit fullscreen mode

🧹 Clean Bundles

Remove only what belongs to the bundle:

./coffee.sh clean aws
Enter fullscreen mode Exit fullscreen mode

Clean all bundles:

./coffee.sh clean
Enter fullscreen mode Exit fullscreen mode

⚠️ Important about Homebrew behavior:
Homebrew may uninstall “unneeded” dependencies while cleaning.
If something breaks, simply reinstall the required bundle:

./coffee.sh install <bundle>
Enter fullscreen mode Exit fullscreen mode

🧱 Creating or Customizing Bundles

All bundles live in the bundles/ directory and follow the format:

<name>.Brewfile
Enter fullscreen mode Exit fullscreen mode

➕ Add a new bundle 

touch bundles/my-new-bundle.Brewfile
Enter fullscreen mode Exit fullscreen mode

Install it:

./coffee.sh install my-new-bundle
Enter fullscreen mode Exit fullscreen mode

✏️ Customize existing bundles

Feel free to add/remove packages to suit your workflow or your team’s environment standards.

🤝 Contributing

Contributions are welcome!

You can:

  • Add new tech stack bundles
  • Improve the CLI scripts
  • Enhance documentation

❤️ Wrap-Up

If you’ve ever wished for a one-command, clean, and repeatable dev setup on macOS — brew-coffee might save you a lot of time.

Give it a try here:
👉 https://github.com/n4en/brew-coffee

If you find it helpful, feel free to ⭐ star the repo or open a PR!

Top comments (0)