How to clean up renamed casks/formulae in brew ls?

[ideabucket]

Output of brew config

HOMEBREW_VERSION: 4.6.10-69-g47b7bf3
ORIGIN: https://github.com/Homebrew/brew
HEAD: 47b7bf378ebc221d211672ab481b3015964540d6
Last commit: 17 hours ago
Branch: main
Core tap JSON: 13 Sep 12:21 UTC
Core cask tap JSON: 13 Sep 12:21 UTC
HOMEBREW_PREFIX: /opt/homebrew
HOMEBREW_CASK_OPTS: []
HOMEBREW_DISPLAY: /private/tmp/com.apple.launchd.8jHzH9T4Pf/org.xquartz:0
HOMEBREW_EDITOR: /opt/homebrew/bin/bbedit --new-window --wait --resume --
HOMEBREW_FORBID_PACKAGES_FROM_PATHS: set
HOMEBREW_MAKE_JOBS: 8
HOMEBREW_SORBET_RUNTIME: set
Homebrew Ruby: 3.4.5 => /opt/homebrew/Library/Homebrew/vendor/portable-ruby/3.4.5/bin/ruby
CPU: octa-core 64-bit arm_blizzard_avalanche
Clang: 17.0.0 build 1700
Git: 2.51.0 => /opt/homebrew/bin/git
Curl: 8.7.1 => /usr/bin/curl
macOS: 15.6.1-arm64
CLT: 26.0
Xcode: 16.4
Rosetta 2: false

Output of brew doctor

Your system is ready to brew.

Description of issue

I have an assortment of formulae and casks installed which were affected by the renames in #227614 and homebrew-cask#217076.

Since the renames, I end up with duplicate entries in brew ls, one for the new name and one for the old, e.g.

handbrake
handbrake-app

Is there some step I need to take to clean up the old names so they don't show any more? The only thing I can find in the documentation that looks like it might be relevant is brew migrate and that does nothing:

$ brew migrate --cask --verbose --debug --dry-run handbrake
/opt/homebrew/Library/Homebrew/brew.rb (Cask::CaskLoader::FromAPILoader): loading handbrake
/opt/homebrew/Library/Homebrew/brew.rb (Cask::CaskLoader::FromPathLoader): loading /opt/homebrew/Caskroom/handbrake-app/.metadata/1.10.2/20250913123018.828/Casks/handbrake-app.json
$ brew ls --cask | grep handbrake
handbrake
handbrake-app

(#6175 seems to be related but is unanswered.)

[bevanjkay]

You can remove the symlinks from your Caskroom (you can run brew --caskroom to find the path), and from the cellar for Formulae (brew --cellar).