{"owner":"Homebrew","repo":"homebrew-cask","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Agent Instructions for homebrew-cask\n\nThis document helps coding agents produce high-quality PRs for Homebrew Cask contributions.\n\n## Before Any PR\n\n1. **Check for existing PRs** for the same cask: [open PRs](https://github.com/Homebrew/homebrew-cask/pulls)\n2. **Check if previously refused**: [closed unmerged PRs](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n\n## Golden Rules\n\n- **One cask per PR**, one intent per PR\n- **Minimal diffs**—change only what's necessary\n- **No drive-by formatting** or unrelated stanza churn\n- **No verbose commentary**—keep PR descriptions short\n- **No non-Homebrew caveats** in PR body or cask file\n- **Use official sources** for download URLs\n- **If unsure about policy** (notability, naming, livecheck), stop and ask before opening a PR\n\n## Version Updates\n\nPreferred method for version bumps:\n\n```sh\nbrew bump --open-pr <cask>\n```\n\nThis handles version/sha256 updates, commit message, and opens the PR automatically.\n\n### Manual Version Updates\n\nIf manual editing is needed:\n\n```sh\nbrew edit --cask <cask>\n# Update version, url, sha256 as needed\n# Do not add unrelated stanza changes\n```\n\nCommit message: `<cask> <version>` (e.g., `firefox 125.0`)\n\n## Cask Fixes\n\nFor bug fixes or improvements to existing casks:\n\n```sh\nbrew edit --cask <cask>\n# Make only the required changes\n```\n\nCommit message: `<cask>: <description>` (e.g., `firefox: fix zap stanza`)\n\n## New Casks\n\n### Notability Requirements\n\nNew casks **will be rejected** if:\n\n- App is too obscure (GitHub: <30 forks/watchers or <75 stars)\n- No public presence beyond \"just `brew install`\"\n- Unmaintained or has unpatched security vulnerabilities\n- Requires SIP to be disabled\n- Download requires login/registration (walled builds)\n- No compiled versions available (use homebrew/core instead)\n- Previously rejected for unfixable issues\n\nSee [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks) for full criteria.\n\n### Creating a New Cask\n\n```sh\nbrew create --cask <url>\n# Edit the generated cask\n```\n\nCommit message: `<cask> <version> (new cask)` (e.g., `myapp 1.0.0 (new cask)`)\n\n### Required Elements\n\n- **Token**: Follow the [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)—lowercase, hyphens, no version numbers\n- **Required stanzas**: `version`, `sha256`, `url`, `name`, `desc`, `homepage`, and at least one artifact (`app`, `pkg`, etc.)\n- **`uninstall` stanza**: Required for `pkg` and `installer` artifacts\n- **`zap` stanza**: Recommended for thorough cleanup (preference files, caches in `~/Library`)\n\n## Required Validation\n\n### For Existing Cask Changes\n\n```sh\nbrew audit --cask --online <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>    # or reinstall\nbrew uninstall --cask <cask>\n```\n\n### For New Casks\n\n```sh\nexport HOMEBREW_NO_INSTALL_FROM_API=1\nbrew audit --cask --new <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>\nbrew uninstall --cask <cask>\n```\n\nAll checks MUST pass locally before opening a PR.\n\n## PR Template Checklist\n\nYou MUST verify all items before submitting:\n\n**For all cask changes:**\n\n- [ ] Submission is for a [stable version](https://docs.brew.sh/Acceptable-Casks#stable-versions) or [documented exception](https://docs.brew.sh/Acceptable-Casks#but-there-is-no-stable-version)\n- [ ] `brew audit --cask --online <cask>` is error-free\n- [ ] `brew style --fix <cask>` reports no offenses\n\n**Additionally, for new casks:**\n\n- [ ] Named according to [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)\n- [ ] Checked cask was not [already refused](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n- [ ] `brew audit --cask --new <cask>` worked successfully\n- [ ] `HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask <cask>` worked successfully\n- [ ] `brew uninstall --cask <cask>` worked successfully\n\n**If AI-assisted:**\n\n- [ ] Personally reviewed, tested, and verified all changes including `zap` stanza paths\n\n## Commit Message Format\n\n- Version update: `appname 1.2.3`\n- New cask: `appname 1.2.3 (new cask)`\n- Fix/change: `appname: <description>`\n- First line MUST be 50 characters or less\n\n## PR Hygiene\n\n### MUST\n\n- One cask change per PR\n- Keep diffs minimal and focused\n- Provide only essential context in PR description\n\n### MUST NOT\n\n- Batch unrelated cask changes\n- Include formatting-only diffs\n- Add verbose logs or AI analysis in PR body\n- Add installation caveats unless the cask DSL requires it\n- Include unrelated refactors or stanza reordering\n\n## PR Description\n\nKeep it minimal:\n\n```\nBuilt and tested locally on [macOS version].\n\n[One sentence if not obvious from title.]\n```\n\nDo NOT include:\n\n- Large command output or logs\n- Lengthy explanations\n- Non-Homebrew installation advice\n\n## CI Failures\n\n1. Reproduce failures locally with the same commands\n2. Read error messages in \"Files changed\" tab annotations\n3. Fix only the failing issue\n4. Push incremental commits (do not squash after opening PR)\n5. If stuck, comment describing what you've tried\n\n## AI Disclosure\n\nIf AI assisted with the PR, check the AI checkbox in the PR template. Briefly describe:\n\n- How AI was used\n- What manual verification was performed (especially `zap` paths)\n\nDo not identify an AI tool as an author, co-author, committer or signatory of a commit, including through an `Assisted-by`, `Co-developed-by` or similar commit trailer.\nAnswer maintainer questions and pull request review comments yourself without using AI.\nAI assistants must not draft or post these responses; the human contributor must answer them directly.\n\n## References\n\n- [Cask Cookbook](https://docs.brew.sh/Cask-Cookbook)\n- [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks)\n- [Adding Software to Homebrew](https://docs.brew.sh/Adding-Software-to-Homebrew#casks)\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [How to Open a PR](https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request)\n"},"files":{"AGENTS.md":"# Agent Instructions for homebrew-cask\n\nThis document helps coding agents produce high-quality PRs for Homebrew Cask contributions.\n\n## Before Any PR\n\n1. **Check for existing PRs** for the same cask: [open PRs](https://github.com/Homebrew/homebrew-cask/pulls)\n2. **Check if previously refused**: [closed unmerged PRs](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n\n## Golden Rules\n\n- **One cask per PR**, one intent per PR\n- **Minimal diffs**—change only what's necessary\n- **No drive-by formatting** or unrelated stanza churn\n- **No verbose commentary**—keep PR descriptions short\n- **No non-Homebrew caveats** in PR body or cask file\n- **Use official sources** for download URLs\n- **If unsure about policy** (notability, naming, livecheck), stop and ask before opening a PR\n\n## Version Updates\n\nPreferred method for version bumps:\n\n```sh\nbrew bump --open-pr <cask>\n```\n\nThis handles version/sha256 updates, commit message, and opens the PR automatically.\n\n### Manual Version Updates\n\nIf manual editing is needed:\n\n```sh\nbrew edit --cask <cask>\n# Update version, url, sha256 as needed\n# Do not add unrelated stanza changes\n```\n\nCommit message: `<cask> <version>` (e.g., `firefox 125.0`)\n\n## Cask Fixes\n\nFor bug fixes or improvements to existing casks:\n\n```sh\nbrew edit --cask <cask>\n# Make only the required changes\n```\n\nCommit message: `<cask>: <description>` (e.g., `firefox: fix zap stanza`)\n\n## New Casks\n\n### Notability Requirements\n\nNew casks **will be rejected** if:\n\n- App is too obscure (GitHub: <30 forks/watchers or <75 stars)\n- No public presence beyond \"just `brew install`\"\n- Unmaintained or has unpatched security vulnerabilities\n- Requires SIP to be disabled\n- Download requires login/registration (walled builds)\n- No compiled versions available (use homebrew/core instead)\n- Previously rejected for unfixable issues\n\nSee [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks) for full criteria.\n\n### Creating a New Cask\n\n```sh\nbrew create --cask <url>\n# Edit the generated cask\n```\n\nCommit message: `<cask> <version> (new cask)` (e.g., `myapp 1.0.0 (new cask)`)\n\n### Required Elements\n\n- **Token**: Follow the [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)—lowercase, hyphens, no version numbers\n- **Required stanzas**: `version`, `sha256`, `url`, `name`, `desc`, `homepage`, and at least one artifact (`app`, `pkg`, etc.)\n- **`uninstall` stanza**: Required for `pkg` and `installer` artifacts\n- **`zap` stanza**: Recommended for thorough cleanup (preference files, caches in `~/Library`)\n\n## Required Validation\n\n### For Existing Cask Changes\n\n```sh\nbrew audit --cask --online <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>    # or reinstall\nbrew uninstall --cask <cask>\n```\n\n### For New Casks\n\n```sh\nexport HOMEBREW_NO_INSTALL_FROM_API=1\nbrew audit --cask --new <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>\nbrew uninstall --cask <cask>\n```\n\nAll checks MUST pass locally before opening a PR.\n\n## PR Template Checklist\n\nYou MUST verify all items before submitting:\n\n**For all cask changes:**\n\n- [ ] Submission is for a [stable version](https://docs.brew.sh/Acceptable-Casks#stable-versions) or [documented exception](https://docs.brew.sh/Acceptable-Casks#but-there-is-no-stable-version)\n- [ ] `brew audit --cask --online <cask>` is error-free\n- [ ] `brew style --fix <cask>` reports no offenses\n\n**Additionally, for new casks:**\n\n- [ ] Named according to [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)\n- [ ] Checked cask was not [already refused](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n- [ ] `brew audit --cask --new <cask>` worked successfully\n- [ ] `HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask <cask>` worked successfully\n- [ ] `brew uninstall --cask <cask>` worked successfully\n\n**If AI-assisted:**\n\n- [ ] Personally reviewed, tested, and verified all changes including `zap` stanza paths\n\n## Commit Message Format\n\n- Version update: `appname 1.2.3`\n- New cask: `appname 1.2.3 (new cask)`\n- Fix/change: `appname: <description>`\n- First line MUST be 50 characters or less\n\n## PR Hygiene\n\n### MUST\n\n- One cask change per PR\n- Keep diffs minimal and focused\n- Provide only essential context in PR description\n\n### MUST NOT\n\n- Batch unrelated cask changes\n- Include formatting-only diffs\n- Add verbose logs or AI analysis in PR body\n- Add installation caveats unless the cask DSL requires it\n- Include unrelated refactors or stanza reordering\n\n## PR Description\n\nKeep it minimal:\n\n```\nBuilt and tested locally on [macOS version].\n\n[One sentence if not obvious from title.]\n```\n\nDo NOT include:\n\n- Large command output or logs\n- Lengthy explanations\n- Non-Homebrew installation advice\n\n## CI Failures\n\n1. Reproduce failures locally with the same commands\n2. Read error messages in \"Files changed\" tab annotations\n3. Fix only the failing issue\n4. Push incremental commits (do not squash after opening PR)\n5. If stuck, comment describing what you've tried\n\n## AI Disclosure\n\nIf AI assisted with the PR, check the AI checkbox in the PR template. Briefly describe:\n\n- How AI was used\n- What manual verification was performed (especially `zap` paths)\n\nDo not identify an AI tool as an author, co-author, committer or signatory of a commit, including through an `Assisted-by`, `Co-developed-by` or similar commit trailer.\nAnswer maintainer questions and pull request review comments yourself without using AI.\nAI assistants must not draft or post these responses; the human contributor must answer them directly.\n\n## References\n\n- [Cask Cookbook](https://docs.brew.sh/Cask-Cookbook)\n- [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks)\n- [Adding Software to Homebrew](https://docs.brew.sh/Adding-Software-to-Homebrew#casks)\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [How to Open a PR](https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request)\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Agent Instructions for homebrew-cask\n\nThis document helps coding agents produce high-quality PRs for Homebrew Cask contributions.\n\n## Before Any PR\n\n1. **Check for existing PRs** for the same cask: [open PRs](https://github.com/Homebrew/homebrew-cask/pulls)\n2. **Check if previously refused**: [closed unmerged PRs](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n\n## Golden Rules\n\n- **One cask per PR**, one intent per PR\n- **Minimal diffs**—change only what's necessary\n- **No drive-by formatting** or unrelated stanza churn\n- **No verbose commentary**—keep PR descriptions short\n- **No non-Homebrew caveats** in PR body or cask file\n- **Use official sources** for download URLs\n- **If unsure about policy** (notability, naming, livecheck), stop and ask before opening a PR\n\n## Version Updates\n\nPreferred method for version bumps:\n\n```sh\nbrew bump --open-pr <cask>\n```\n\nThis handles version/sha256 updates, commit message, and opens the PR automatically.\n\n### Manual Version Updates\n\nIf manual editing is needed:\n\n```sh\nbrew edit --cask <cask>\n# Update version, url, sha256 as needed\n# Do not add unrelated stanza changes\n```\n\nCommit message: `<cask> <version>` (e.g., `firefox 125.0`)\n\n## Cask Fixes\n\nFor bug fixes or improvements to existing casks:\n\n```sh\nbrew edit --cask <cask>\n# Make only the required changes\n```\n\nCommit message: `<cask>: <description>` (e.g., `firefox: fix zap stanza`)\n\n## New Casks\n\n### Notability Requirements\n\nNew casks **will be rejected** if:\n\n- App is too obscure (GitHub: <30 forks/watchers or <75 stars)\n- No public presence beyond \"just `brew install`\"\n- Unmaintained or has unpatched security vulnerabilities\n- Requires SIP to be disabled\n- Download requires login/registration (walled builds)\n- No compiled versions available (use homebrew/core instead)\n- Previously rejected for unfixable issues\n\nSee [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks) for full criteria.\n\n### Creating a New Cask\n\n```sh\nbrew create --cask <url>\n# Edit the generated cask\n```\n\nCommit message: `<cask> <version> (new cask)` (e.g., `myapp 1.0.0 (new cask)`)\n\n### Required Elements\n\n- **Token**: Follow the [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)—lowercase, hyphens, no version numbers\n- **Required stanzas**: `version`, `sha256`, `url`, `name`, `desc`, `homepage`, and at least one artifact (`app`, `pkg`, etc.)\n- **`uninstall` stanza**: Required for `pkg` and `installer` artifacts\n- **`zap` stanza**: Recommended for thorough cleanup (preference files, caches in `~/Library`)\n\n## Required Validation\n\n### For Existing Cask Changes\n\n```sh\nbrew audit --cask --online <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>    # or reinstall\nbrew uninstall --cask <cask>\n```\n\n### For New Casks\n\n```sh\nexport HOMEBREW_NO_INSTALL_FROM_API=1\nbrew audit --cask --new <cask>\nbrew style --fix <cask>\nbrew install --cask <cask>\nbrew uninstall --cask <cask>\n```\n\nAll checks MUST pass locally before opening a PR.\n\n## PR Template Checklist\n\nYou MUST verify all items before submitting:\n\n**For all cask changes:**\n\n- [ ] Submission is for a [stable version](https://docs.brew.sh/Acceptable-Casks#stable-versions) or [documented exception](https://docs.brew.sh/Acceptable-Casks#but-there-is-no-stable-version)\n- [ ] `brew audit --cask --online <cask>` is error-free\n- [ ] `brew style --fix <cask>` reports no offenses\n\n**Additionally, for new casks:**\n\n- [ ] Named according to [token reference](https://docs.brew.sh/Cask-Cookbook#token-reference)\n- [ ] Checked cask was not [already refused](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-cask+is%3Aclosed+is%3Aunmerged+&type=pullrequests)\n- [ ] `brew audit --cask --new <cask>` worked successfully\n- [ ] `HOMEBREW_NO_INSTALL_FROM_API=1 brew install --cask <cask>` worked successfully\n- [ ] `brew uninstall --cask <cask>` worked successfully\n\n**If AI-assisted:**\n\n- [ ] Personally reviewed, tested, and verified all changes including `zap` stanza paths\n\n## Commit Message Format\n\n- Version update: `appname 1.2.3`\n- New cask: `appname 1.2.3 (new cask)`\n- Fix/change: `appname: <description>`\n- First line MUST be 50 characters or less\n\n## PR Hygiene\n\n### MUST\n\n- One cask change per PR\n- Keep diffs minimal and focused\n- Provide only essential context in PR description\n\n### MUST NOT\n\n- Batch unrelated cask changes\n- Include formatting-only diffs\n- Add verbose logs or AI analysis in PR body\n- Add installation caveats unless the cask DSL requires it\n- Include unrelated refactors or stanza reordering\n\n## PR Description\n\nKeep it minimal:\n\n```\nBuilt and tested locally on [macOS version].\n\n[One sentence if not obvious from title.]\n```\n\nDo NOT include:\n\n- Large command output or logs\n- Lengthy explanations\n- Non-Homebrew installation advice\n\n## CI Failures\n\n1. Reproduce failures locally with the same commands\n2. Read error messages in \"Files changed\" tab annotations\n3. Fix only the failing issue\n4. Push incremental commits (do not squash after opening PR)\n5. If stuck, comment describing what you've tried\n\n## AI Disclosure\n\nIf AI assisted with the PR, check the AI checkbox in the PR template. Briefly describe:\n\n- How AI was used\n- What manual verification was performed (especially `zap` paths)\n\nDo not identify an AI tool as an author, co-author, committer or signatory of a commit, including through an `Assisted-by`, `Co-developed-by` or similar commit trailer.\nAnswer maintainer questions and pull request review comments yourself without using AI.\nAI assistants must not draft or post these responses; the human contributor must answer them directly.\n\n## References\n\n- [Cask Cookbook](https://docs.brew.sh/Cask-Cookbook)\n- [Acceptable Casks](https://docs.brew.sh/Acceptable-Casks)\n- [Adding Software to Homebrew](https://docs.brew.sh/Adding-Software-to-Homebrew#casks)\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [How to Open a PR](https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request)\n","category":"root","tokens":1492}]}