Docs: troubleshoot `chatgpt.openSidebar` failure caused by read-only macOS VS Code installation

Documentation request

Please add a macOS troubleshooting entry for this user-visible Codex IDE extension error:

command 'chatgpt.openSidebar' not found

Observed behavior

The Codex extension was installed and its contributed UI elements were visible, including Codex: Open Codex Sidebar, but clicking the command failed because the extension did not activate.

The VS Code extension-host log showed:

ExtensionService#_doActivateExtension openai.chatgpt
Activating extension openai.chatgpt failed due to an error

Environment observed:

• macOS arm64
• VS Code
• Codex extension: openai.chatgpt@26.901.22334

Reinstalling the Codex extension and restarting VS Code did not resolve it.

Root cause and confirmed recovery path

VS Code itself was outdated, but could not update because it was running from a read-only/translocated location. VS Code displayed:

Cannot update while running on a read-only volume.
The application is on a read-only volume. Please move the application and try again.

The working recovery path was:

1. Quit VS Code completely.
2. Move Visual Studio Code.app into /Applications.
3. Eject the mounted Visual Studio Code disk image, if present.
4. Remove any Dock shortcut pointing to the old copy and launch VS Code from /Applications.
5. If macOS still treats the app as quarantined, clear the quarantine attribute:

   xattr -dr com.apple.quarantine "/Applications/Visual Studio Code.app"
   

6. Update VS Code.
7. Restart the extension host or reopen VS Code.
8. Run Codex: Open Codex Sidebar.

After VS Code could update, the Codex extension activated and the sidebar worked.

Suggested documentation placement

Add this under Codex IDE extension troubleshooting, with a cross-reference from the missing-command/extension-activation section.

It would also help to clarify that chatgpt.openSidebar is the internal command ID for Codex: Open Codex Sidebar. The error does not necessarily indicate that an obsolete ChatGPT keybinding should be deleted; it can mean the Codex extension failed before registering its commands.

Why this would help

The visible symptom initially looks like a stale shortcut or bad Codex installation. Reinstalling Codex does not help when the actual blocker is that VS Code cannot update from a read-only macOS location. Documenting the connection would shorten diagnosis and avoid repeated extension reinstalls.

Start in the Codex IDE extension troubleshooting documentation and locate the missing-command or extension-activation section. Add the macOS read-only-volume recovery path and explain that chatgpt.openSidebar is the internal ID for Codex: Open Codex Sidebar; add the requested cross-reference and verify the documented steps match the confirmed recovery path.