Skip to content

Remove basecamp -> basecamp-cli cask rename#2

Merged
jeremy merged 2 commits into
mainfrom
fix/remove-basecamp-cask-rename
Jun 2, 2026
Merged

Remove basecamp -> basecamp-cli cask rename#2
jeremy merged 2 commits into
mainfrom
fix/remove-basecamp-cask-rename

Conversation

@jeremy
Copy link
Copy Markdown
Member

@jeremy jeremy commented Jun 2, 2026

Problem

Users running the documented brew install basecamp/tap/basecamp-cli hit:

Error: basecamp/tap/basecamp-cli: It seems the App source '/Applications/Basecamp 3.app' is not there.

Root cause. This tap's cask_renames.json mapped the token basecampbasecamp-cli. The rename was legitimate — the CLI was first published here as the cask token basecamp (v0.7.0), then renamed to basecamp-cli in bc7a916 — and was meant to auto-migrate those early installs.

But basecamp collides with the official Basecamp desktop-app cask in homebrew/cask. When a user with the desktop app taps basecamp/tap and installs the CLI, Homebrew sees the rename, treats the installed desktop-app basecamp as an old basecamp-cli, tries to migrate/upgrade it, and fails purging the desktop app's artifacts (/Applications/Basecamp 3.app, gone after upgrading to Basecamp.app 5.x).

Fix

  • Remove cask_renames.json so Homebrew stops conflating the desktop app with the CLI. (Homebrew treats a missing file as "no renames".)
  • Update README.md to document the explicit --cask install and a brew reinstall recovery command.

Casks/basecamp-cli.rb is untouched (it's GoReleaser-owned and already correct).

Trade-off (accepted)

The handful who installed the CLI as basecamp/tap/basecamp (v0.7.0) lose auto-migration; they re-install as basecamp-cli (covered by the README recovery note). The desktop-app collision — affecting far more users — is eliminated. The CLI is brand new (0.7.0 → 0.7.2), so the migration population is tiny.

Verification

  • brew readall basecamp/tap parses the tap cleanly (no output, no errors).
  • brew audit --cask --tap basecamp/tap basecamp-cli exits 0.
  • With no rename, an installed homebrew/cask basecamp (desktop app) is no longer matched to basecamp/tap/basecamp-cli, so the install proceeds cleanly instead of attempting the desktop-app migration/purge.

Fixes basecamp/basecamp-cli#477

The rename mapped the token `basecamp` to `basecamp-cli`, but `basecamp`
collides with the official Basecamp desktop-app cask in homebrew/cask. Users
with the desktop app installed who ran `brew install basecamp/tap/basecamp-cli`
hit Homebrew treating the installed desktop app as an old basecamp-cli, then
failing to purge `/Applications/Basecamp 3.app`.

Dropping the rename stops Homebrew conflating the desktop app with the CLI.
Document the explicit --cask install and a reinstall recovery command for the
small number of early adopters who installed the CLI as `basecamp` (v0.7.0).

Fixes basecamp/basecamp-cli#477
Copilot AI review requested due to automatic review settings June 2, 2026 17:11
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR removes the basecampbasecamp-cli cask rename to prevent Homebrew from mistakenly attempting to migrate/purge the official homebrew/cask Basecamp desktop app when users install the Basecamp CLI from this tap, and updates the README with clearer installation/recovery guidance.

Changes:

  • Removed cask_renames.json to eliminate the basecamp token collision-driven migration behavior.
  • Updated README.md to document brew install --cask basecamp/tap/basecamp-cli and a recovery-oriented reinstall flow.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
README.md Clarifies cask-specific install and adds recovery guidance for prior installs/migration errors.
cask_renames.json Removes the rename mapping that caused collisions with the official desktop-app cask.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

@jeremy jeremy merged commit 2997b2a into main Jun 2, 2026
3 checks passed
@jeremy jeremy deleted the fix/remove-basecamp-cask-rename branch June 2, 2026 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Error: basecamp/tap/basecamp-cli: It seems the App source '/Applications/Basecamp 3.app' is not there.

2 participants