Introducing brew-coffee - One Command Dev Environment Setup

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

Make the script executable

chmod +x ./coffee.sh

☕ Usage Guide

📜 List Bundles

./coffee.sh list

Example:

 - python
 - nodejs
 - aws
 - azure
 - gcp
 - k8s
 - infra
 - dev

▶️ Install Bundles

Single bundle:

./coffee.sh install python

Multiple bundles:

./coffee.sh install python nodejs aws

Install everything:

./coffee.sh install

🔍 Check Installation Status

Check one bundle:

./coffee.sh check aws

Check all:

./coffee.sh check

🧹 Clean Bundles

Remove only what belongs to the bundle:

./coffee.sh clean aws

Clean all bundles:

./coffee.sh clean

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

./coffee.sh install <bundle>

🧱 Creating or Customizing Bundles

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

<name>.Brewfile

➕ Add a new bundle

touch bundles/my-new-bundle.Brewfile

Install it:

./coffee.sh install my-new-bundle

✏️ 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!