fix: install Pinecone CLI as a Homebrew cask (formula disabled 2026-03-30)

[mcdgavin]

Problem

The Pinecone CLI install instructions no longer work. The pinecone-io/tap/pinecone formula was disabled on 2026-03-30 when the CLI migrated to a cask, so following the docs today produces:

Error: pinecone-io/tap/pinecone has been disabled because it has migrated to a
cask. Reinstall with: brew uninstall pinecone-io/tap/pinecone && brew install
--cask pinecone-io/tap/pinecone! It was disabled on 2026-03-30.

Verified against the tap: Formula/pinecone.rb carries disable! date: "2026-03-30" pointing at the cask, and Casks/pinecone.rb is the live GoReleaser-generated cask (currently 1.0.1). pinecone-io/cli's README already documents the cask form.

Fix

Switch every install instruction to a single fully qualified command:

brew install --cask pinecone-io/tap/pinecone

File	Change
README.md	one-liner in the prerequisites table
The two skills/pinecone-* files carry the same stale command but are rendered from pinecone-io/skills by the sync workflow, so they are fixed by pinecone-io/skills#33 rather than here.

The upgrade note tells anyone who installed before the migration to run brew uninstall pinecone-io/tap/pinecone first, since Homebrew refuses to install the cask over the disabled formula.

Why drop the separate brew tap step

• brew install taps automatically for a fully qualified user/repo/name (cmd/install.rb calls tap.ensure_installed! on each named argument).
• Since Homebrew 6.0.0, non-official taps require explicit trust. Installing a fully qualified cask trusts only that cask; the tap-then-short-name form now additionally needs brew trust. Homebrew's Tap Trust docs give brew install --cask user/repository/cask as the canonical form.
• Matches peer vendor taps (HashiCorp brew install hashicorp/tap/terraform, Supabase brew install supabase/tap/supabase).

Verification

• Clean-state run on Homebrew 6.0.22, starting with the tap untapped, no trust entries, and no cask installed. brew install --cask pinecone-io/tap/pinecone alone tapped pinecone-io/tap, printed Trusted cask pinecone-io/tap/pinecone (item-level trust, not whole-tap), installed cask 1.0.1, and pc version prints 1.0.1. Exit 0. Note the tap still ships the disabled formula alongside the cask (Tapped 1 cask and 1 formula), which is why the old command produced the confusing "Treating ... as a formula" warning before failing.
• grep -rn "brew tap pinecone-io\|brew install pinecone-io/tap" over the repo returns nothing.

Related

Same fix across the org: pinecone-io/pinecone-claude-code-plugin#46 (plugin), pinecone-io/skills#33 (base skills, which the Claude Code and Cursor plugins sync from).