Setup & Installation
What This Skill Does
Diagnoses and fixes connectivity failures between the Claude in Chrome MCP extension and Claude Code CLI on macOS. The core problem it solves is a conflict between Claude.app (Cowork) and Claude Code CLI, which register competing native messaging hosts in Chrome with incompatible socket formats. Covers socket path mismatches, stale version wrappers, multiple Chrome profiles, and TMPDIR misconfiguration.
Without this skill, diagnosing the Claude.app vs Claude Code native host conflict requires manually cross-referencing socket paths, native messaging JSON configs, and running process lists — steps that are non-obvious and scattered across macOS-specific locations.
When to use it
- Fixing 'Browser extension is not connected' errors when mcp__claude-in-chrome__* tools fail
- Switching the active native messaging host between Claude Code CLI and Claude.app Cowork
- Resetting the chrome-native-host wrapper to dynamically pick the latest Claude Code version after an update
- Diagnosing which native host binary is running and whether it created the socket in the expected location
- Resolving socket conflicts caused by running multiple Claude Code sessions or Chrome profiles