{"id":28394799,"url":"https://github.com/revett/hops","last_synced_at":"2026-03-04T22:01:47.026Z","repository":{"id":295280442,"uuid":"988981090","full_name":"revett/hops","owner":"revett","description":"Manage Homebrew packages across machines using a single YAML file.","archived":false,"fork":false,"pushed_at":"2025-07-22T19:32:01.000Z","size":742,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-22T21:16:26.015Z","etag":null,"topics":["automation","brewfile","cli","devtools","dotfiles","homebrew","macos"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/revett.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-23T11:22:29.000Z","updated_at":"2025-07-22T19:31:32.000Z","dependencies_parsed_at":"2025-06-11T20:57:59.216Z","dependency_job_id":"2d930a4b-d9e3-484b-8aa4-27737dfdf659","html_url":"https://github.com/revett/hops","commit_stats":null,"previous_names":["revett/hops"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/revett/hops","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/revett%2Fhops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/revett%2Fhops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/revett%2Fhops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/revett%2Fhops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/revett","download_url":"https://codeload.github.com/revett/hops/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/revett%2Fhops/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30095693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T21:59:23.547Z","status":"ssl_error","status_checked_at":"2026-03-04T21:57:50.415Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","brewfile","cli","devtools","dotfiles","homebrew","macos"],"created_at":"2025-05-31T19:00:25.527Z","updated_at":"2026-03-04T22:01:47.017Z","avatar_url":"https://github.com/revett.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/logo.png\" width=\"250px\"\u003e\n\u003c/p\u003e\n\n# hops\n\nManage [Homebrew](https://brew.sh) packages across multiple machines with a single YAML file.\n\n![hops-v0 3 1-demo](https://github.com/user-attachments/assets/253624a3-270a-4f17-b92f-825593b426f7)\n\n## Why?\n\nManaging Homebrew packages with `Brewfile` is great, until you're juggling multiple machines.\nHops replaces scattered, duplicated configurations with a single declarative YAML config.\n\n- ✅ One `hops.yml` config for all machines\n- 📦 Generates a specific `Brewfile` for each machine\n- 🧹 Prune unused floating packages\n- ⚡ Installs, upgrades, and verifies with one command\n- 💻 Designed for dotfiles\n\n```yaml\nbrewfile: /Users/snape/Brewfile\nmachines:\n  shared:\n    taps:\n      - homebrew/bundle\n    formulae:\n      - coreutils\n    casks:\n      - 1password\n      - raycast\n      - spotify\n  personal:\n    casks:\n      - adobe-creative-cloud\n  work:\n    casks:\n      - cursor\n      - loom\n      - slack\n    cursor:\n      - dbaeumer.vscode-eslint\n      - github.github-vscode-theme\n```\n\n## Install\n\n### GitHub Release\n\n```bash\n# Download the latest release\n# Visit → https://github.com/revett/hops/releases\n\n# Extract binary from archive\ntar -xzf hops_X.Y.Z_darwin_arm64.tar.gz\n\n# Stop macOS' Gatekeeper from blocking the binary\nxattr -c ./hops\n\n# Move binary\nsudo mv hops /usr/local/bin\n\n# Verify install\nhops -h\n```\n\n### Build from Source\n\n\n```bash\n# Clone repo locally\ngit clone https://github.com/revett/hops.git\n\n# Build binary\ncd hops\nmake build\n\n# Move binary\nsudo mv hops /usr/local/bin\n\n# Verify install\nhops -h\n```\n\n## Usage\n\nOptionally set the `HOPS_CONFIG` environment variable within your terminal profile:\n\n```bash\n# Defaults to ~/hops.yml if not set\nexport HOPS_CONFIG=/path/to/hops.yml\n```\n\nInitialise the configuration file:\n\n```bash\nhops init\n```\n\nThis will create a `hops.yml` with a set of example packages; update these with your desired set of\nmachines and packages. This config file is designed to sit in your dotfiles and sync across all your\nmachines.\n\nApply the configuration for a specific machine:\n\n```bash\nhops generate --machine work\nhops apply --machine work\n```\n\nHops will take care of:\n\n- Creating a local `Brewfile` made up of the correct shared and machine specific packages\n- Install any missing packages\n- Update any outdated packages\n- Remove any floating packages that are not outlined in the `Brewfile`\n\n## Commands\n\n```bash\n# Initialize a new hops.yml configuration file with examples\nhops init\n\n# Generate a local Brewfile for a specific machine without installing anything\nhops generate --machine work\n\n# Generate Brewfile and apply changes via Homebrew commands (install, upgrade, cleanup)\nhops apply --machine personal\n\n# Format hops.yml (sort packages A-Z, order sections, 2-space indent)\nhops format\n\n# Add to .zshrc to remind every week to run apply command\nhops reminder\n```\n\n## Examples\n\nSee [hops.yml](https://github.com/revett/dotfiles/blob/main/hops.yml) in\n[revett/dotfiles](https://github.com/revett/dotfiles).\n\n## FAQ\n\n**Does it support Cursor extensions?**\n\nYes, as part of the [v4.5.0](https://brew.sh/2025/04/29/homebrew-4.5.0/) release of Homebrew on 29th\nApril 2025, the `brew bundle` command looks for VS Code variants, see\n[#19545](https://github.com/Homebrew/brew/pull/19545).\n\n## Project\n\n### Releases\n\n1. Ensure that version in `package.json` is bumped\n1. `git tag -a vX.Y.Z -m \"Release vX.Y.Z\"`\n1. `git push origin vX.Y.Z`\n1. `make release VERSION=vX.Y.Z`\n1. Create release in GitHub\n\n### Local Development\n\nSee [CLAUDE.md](./CLAUDE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevett%2Fhops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frevett%2Fhops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frevett%2Fhops/lists"}