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

The `pinecone-io/tap/pinecone` formula was disabled on 2026-03-30 when the
CLI migrated to a cask, so the documented `brew install pinecone-io/tap/pinecone`
now fails with:

    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!

Switch every install instruction to the single fully qualified command:

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

The separate `brew tap pinecone-io/tap` step is dropped. `brew install`
taps automatically for a fully qualified name, and under Homebrew 6 tap
trust the fully qualified form grants trust to only this cask. This is the
form Homebrew's Tap Trust docs give and the form pinecone-io/cli's README
already uses.

Updated:

- README.md (plus a note for users upgrading from the old formula)
- hooks/pinecone-api-key-check.sh (session-start CLI guidance)
- skills/cli/SKILL.md
- skills/help/SKILL.md

The two skills/ files are sync-managed from pinecone-io/skills; the same
fix is submitted there so the next sync reproduces these edits.

Author: mcdgavin

README.md

@@ -83,10 +83,15 @@ Full installation guide: https://docs.astral.sh/uv/getting-started/installation/
 For additional command-line capabilities, install the Pinecone CLI:
 
 ```bash
-brew tap pinecone-io/tap
-brew install pinecone-io/tap/pinecone
+brew install --cask pinecone-io/tap/pinecone
 ```
 
+> **Upgrading from an older install?** The Pinecone CLI moved from a Homebrew formula to a cask on 2026-03-30. If you installed it before then, remove the old formula first:
+>
+> ```bash
+> brew uninstall pinecone-io/tap/pinecone
+> ```
+
 ## Available Skills
 
 ### `/pinecone:help`

hooks/pinecone-api-key-check.sh

@@ -43,7 +43,7 @@ EOF
 
 read -r -d '' CLI_HELP <<'EOF' || true
 Install the Pinecone CLI (optional — enables terminal management of all index types, batch ops, and backups):
-    brew tap pinecone-io/tap && brew install pinecone-io/tap/pinecone
+    brew install --cask pinecone-io/tap/pinecone
 Then run `pc login` directly in a terminal (not inside an agent loop — the browser auth link may not surface in-agent). Note: `pc login` authenticates the CLI only; it does not set PINECONE_API_KEY.
 EOF
 

skills/cli/SKILL.md

@@ -25,10 +25,15 @@ Manage Pinecone from the terminal. The CLI is especially valuable for vector ope
 
 ### Install (macOS)
 ```bash
-brew tap pinecone-io/tap
-brew install pinecone-io/tap/pinecone
+brew install --cask pinecone-io/tap/pinecone
 ```
 
+> **Upgrading from an older install?** The Pinecone CLI moved from a Homebrew formula to a cask on 2026-03-30. If you installed it before then, remove the old formula first:
+>
+> ```bash
+> brew uninstall pinecone-io/tap/pinecone
+> ```
+
 Other platforms (Linux, Windows) — download from [GitHub Releases](https://github.com/pinecone-io/cli/releases).
 
 ### Authenticate

skills/help/SKILL.md

@@ -29,7 +29,7 @@ Invoke any skill from chat with `/pinecone:<skill-name>` — for example `/pinec
 | Tool | What it enables | Install |
 |---|---|---|
 | **Pinecone MCP server** | Use Pinecone directly inside your AI agent/IDE without writing code | [Setup guide](https://docs.pinecone.io/guides/operations/mcp-server#tools) |
-| **Pinecone CLI (`pc`)** | Manage all index types from the terminal, batch operations, backups, CI/CD | `brew tap pinecone-io/tap && brew install pinecone-io/tap/pinecone` |
+| **Pinecone CLI (`pc`)** | Manage all index types from the terminal, batch operations, backups, CI/CD | `brew install --cask pinecone-io/tap/pinecone` |
 | **uv** | Run the packaged Python scripts included in these skills | [Install uv](https://docs.astral.sh/uv/getting-started/installation/) |
 
 ---