How to clean up old version of updated pi-coding-agent?

[abitrolly]

Additional Info

• I am using Windows Subsystem for Linux

Output of brew config

HOMEBREW_VERSION: 6.0.6-16-g8d94d5c
ORIGIN: https://github.com/Homebrew/brew
HEAD: 8d94d5c7cffe2c104a27c92605f6f8df3767338c
Last commit: 14 hours ago
Branch: main
Core tap HEAD: 9d7749ee6897ab65e9729dbca99123ee9977d45c
Core tap last commit: 33 hours ago
HOMEBREW_PREFIX: /home/linuxbrew/.linuxbrew
HOMEBREW_CASK_OPTS: []
HOMEBREW_DISPLAY: :0
HOMEBREW_DOWNLOAD_CONCURRENCY: 8
HOMEBREW_FORBID_PACKAGES_FROM_PATHS: set
HOMEBREW_MAKE_JOBS: 4
HOMEBREW_REQUIRE_TAP_TRUST: set
Homebrew Ruby: 4.0.5 => /home/linuxbrew/.linuxbrew/Homebrew/Library/Homebrew/vendor/portable-ruby/4.0.5_1/bin/ruby
CPU: quad-core 64-bit haswell
Clang: N/A
Git: 2.54.0 => /bin/git
Curl: 8.15.0 => /bin/curl
Kernel: Linux 7.0.13-100.fc43.x86_64 x86_64 GNU/Linux
OS: Fedora Linux 43 (Workstation Edition)
Host glibc: 2.42
Host libstdc++: 6.0.34
/usr/bin/gcc: 15.2.1
/usr/bin/ruby: N/A
glibc: N/A
gcc@13: N/A
gcc: 16.1.0
xorg: N/A

Output of brew doctor

Please note that these warnings are just used to help the Homebrew maintainers
with debugging if you file an issue. If everything you use Homebrew for is
working fine: please don't worry or file an issue; just ignore this. Thanks!

Warning: Some installed kegs have no formulae!
This means they were either deleted or installed manually.
You should find replacements for the following formulae:
  p9ufs

Warning: You have uncommitted modifications to Homebrew/homebrew-core.
If this is a surprise to you, then you should stash these modifications.
Stashing returns Homebrew to a pristine state but can be undone
should you later need to do so for some reason.
  git -C "/home/linuxbrew/.linuxbrew/Homebrew/Library/Taps/homebrew/homebrew-core" stash -u && git -C "/home/linuxbrew/.linuxbrew/Homebrew/Library/Taps/homebrew/homebrew-core" clean -d -f

Uncommitted files:
  ?? Formula/p/p9ufs.rb
  ?? Formula/r/rquickshare.rb

Description of issue

pi-coding-agent updated to a new major version (0.80.3 from 0.70.6) but after the update I still got the old version running.

$ pi

 pi v0.70.6                                                                                                                                                             
 escape interrupt · ctrl+c/ctrl+d clear/exit · / commands · ! bash · ctrl+o more                                                                                        
 Press ctrl+o to show full startup help and loaded resources.                                                                                                           
                                                                                                                                                                        
 Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.                                                                                  


 Warning: No models available. Use /login to log into a provider via OAuth or API key. See:                                                                             
   /home/linuxbrew/.linuxbrew/lib/node_modules/@mariozechner/pi-coding-agent/docs/providers.md                                                                          
   /home/linuxbrew/.linuxbrew/lib/node_modules/@mariozechner/pi-coding-agent/docs/models.md                                                                             

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 Update Available                                                                                                                                                       
 New version 0.73.1 is available. Run pi update                                                                                                                         
 Changelog: https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/CHANGELOG.md                                                                            

I guess it is caused by upstream module rename in Homebrew/homebrew-core#282124 and improper clean up of former file by brew up pi-coding-agent, because even after uninstalling the pi-coding-agent it is still runnable.

Trying to install pi-coding-agent again gives Error: The `brew link` step did not complete successfully.

$ brew install pi-coding-agent
==> Auto-updating Homebrew...
Adjust how often this is run with `$HOMEBREW_AUTO_UPDATE_SECS` or disable with
`$HOMEBREW_NO_AUTO_UPDATE=1`. Hide these hints with `$HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> Would install 1 formula:
pi-coding-agent
==> Downloading https://ghcr.io/v2/homebrew/core/pi-coding-agent/manifests/0.80.3
Already downloaded: /home/anatoli/.cache/Homebrew/downloads/1b5965aeb349ee9d0c7db3ab840c48b795561d9f018e0198d386695fc47e4bc2--pi-coding-agent-0.80.3.bottle_manifest.json
==> Fetching downloads for: pi-coding-agent
✔︎ Bottle pi-coding-agent (0.80.3)                                                                                                            Preparing    23.7MB/ 23.7MB
==> Pouring pi-coding-agent--0.80.3.x86_64_linux.bottle.tar.gz
Error: The `brew link` step did not complete successfully
The formula built, but is not symlinked into /home/linuxbrew/.linuxbrew
Could not symlink bin/pi
Target /home/linuxbrew/.linuxbrew/bin/pi
already exists. You may want to remove it:
  rm '/home/linuxbrew/.linuxbrew/bin/pi'

To force the link and overwrite all conflicting files:
  brew link --overwrite pi-coding-agent

To list all files that would be deleted:
  brew link --overwrite pi-coding-agent --dry-run

Possible conflicting files are:
/home/linuxbrew/.linuxbrew/bin/pi -> /home/linuxbrew/.linuxbrew/lib/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
==> Caveats
The following pi-coding-agent executables are shadowed by other commands earlier in your PATH:
  pi (shadowed by /home/linuxbrew/.linuxbrew/bin/pi)
Running these by name will not invoke the version provided by Homebrew.
Disable this behaviour by setting `HOMEBREW_NO_PATH_SHADOW_CHECK=1`.
Hide these hints with `HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> Summary
🍺  /home/linuxbrew/.linuxbrew/Cellar/pi-coding-agent/0.80.3: 18,601 files, 122.5MB
==> Running `brew cleanup pi-coding-agent`...
Disable this behaviour by setting `HOMEBREW_NO_INSTALL_CLEANUP=1`.
Hide these hints with `HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).

I can force the link, but it seems there would be 120Mb of lost disk space due to old pi version still hanging around. So how to clean up this mess?

[cho-m]

Possible conflicting files are:
/home/linuxbrew/.linuxbrew/bin/pi -> /home/linuxbrew/.linuxbrew/lib/node_modules/@mariozechner/pi-coding-agent/dist/cli.js

I'm guessing you ran pi update at some point. This will install a separate copy of pi-coding-agent that cannot be managed by Homebrew and will break the formula update.

Files in /home/linuxbrew/.linuxbrew/lib/node_modules/ are user-maintained other than npm.

If you,

• want to use formula, then avoid running self-upgrade commands. You will need to manually delete the files that were installed, maybe via npm uninstall -g or rm -r or any other way you prefer.
• want to use self-upgrade, then you can uninstall the formula and manage the installation via pi update or npm commands.

---

If upstream provides a way to disable self-upgrade, then it can be added to formula. Otherwise, users will need to avoid running it. This is why we typically dislike tools that have self-upgrade commands

• https://docs.brew.sh/Acceptable-Formulae#we-dont-like-tools-that-upgrade-themselves

[abitrolly]

I don't remember running pi update, but it does version check on startup and proposes the update, so I could have agreed to that at some point. I submitted Homebrew/homebrew-core#291178 to disable the version check. That won't prevent people from running pi update, but at least it will be harder to shoot in the foot.