skill CX Codex

chrome-mcp-troubleshooting — Claude Code skill: how to install

Q: How to install chrome-mcp-troubleshooting in Claude Code?

Run `npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a claude-code` in your terminal.

Troubleshoots native host clashes between Claude Code and Chrome on macOS. Fixes broken bridge connections when browser tools refuse to run.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a claude-code

Open on GitHub

What chrome-mcp-troubleshooting does

This skill resolves integration failures between the browser extension and the terminal agent. The root dilemma stems from two competing native hosts on macOS. When Claude.app Cowork is installed alongside Claude Code, both register native messaging definitions in Chrome. The browser picks the wrong binary, creating socket files in an unexpected location. The CLI agent fails to locate the pipe and aborts automation calls.

Inside you will find diagnosis commands targeting Darwin temporary paths, running processes, and active JSON manifests. The guide outlines how to rename the conflicting desktop host configuration and supplies a shell function to toggle between Cowork and CLI modes. It also includes an orderly reset workflow using osascript and process termination.

Because this playbook depends on paths like ~/Library/Application Support/, it is completely ineffective on Windows or Linux machines. Another strict detail matters: MCP client connections happen only during startup. You must launch and configure Chrome before starting the Claude Code session.

What it helps with

Resolve native messaging host conflicts between Claude.app and Claude Code
Clear stale socket files in Darwin temporary folders
Switch Chrome native messaging configs with a shell helper
Fix disconnected browser MCP tools after application updates

Example prompts for the agent

Diagnose why mcp__claude-in-chrome reports that the browser extension is disconnected
Check which native messaging host is active for my Chrome Claude extension
Help me toggle the Chrome native host from Claude.app to Claude Code CLI

How to install chrome-mcp-troubleshooting

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a claude-code

2Manually: put the files in place

~/.claude/skills/chrome-mcp-troubleshooting/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/chrome-mcp-troubleshooting/

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a codex

2Manually: put the files in place

.agents/skills/chrome-mcp-troubleshooting/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a cursor

2Manually: put the files in place

.cursor/skills/chrome-mcp-troubleshooting/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install trailofbits/skills chrome-mcp-troubleshooting

2Manually: put the files in place

.github/skills/chrome-mcp-troubleshooting/SKILL.md

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a gemini-cli

2Platform CLI

gemini skills install https://github.com/trailofbits/skills --path plugins/chrome-mcp-troubleshooting/skills/chrome-mcp-troubleshooting

Manually: put the files in place

.devin/skills/chrome-mcp-troubleshooting/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about chrome-mcp-troubleshooting

How to install chrome-mcp-troubleshooting in Claude Code?

Run npx skills add trailofbits/skills --skill chrome-mcp-troubleshooting -a claude-code in your terminal.

What causes the Claude in Chrome connection error?

Both Claude.app and Claude Code register native messaging configs in Chrome, causing the browser to spawn the wrong host binary and mismatched socket paths.

Does chrome-mcp-troubleshooting support Windows or Linux?

No, the instructions and scripts rely strictly on macOS filesystem locations and utilities such as osascript.

chrome-devtools official github Controls a live Chrome browser through Chrome DevTools MCP for page actions, debugging, and performance traces. Use it when an agent needs to inspect a web interface. 15,258installs chrome-devtools-axi Kun Chen (kunchenguid) A skill that hands the agent a live Chrome session: navigation, DOM snapshots, clicks, forms, screenshots, console and network. Reach for it when a plain request will not do. CX Codex +1 6,900installs chrome-devtools-cli ChromeDevTools Lets AI coding agents interact with Chrome DevTools to automate clicks, inspect DOM snapshots, profile performance, and debug heap memory from the terminal. CX Codex +1 6,800installs chrome-cdp pasky Connects AI coding agents to an active Chrome browser session using DevTools Protocol. Useful for inspecting open tabs, clicking elements, and taking viewport screenshots. CX Codex +1 2,100installs troubleshooting ChromeDevTools Diagnoses connection failures and tool errors in Chrome DevTools MCP step by step. Helpful when the server refuses to launch or tab commands fail. CX Codex +1 3,200installs d3k vercel-labs Runs a project dev server and a monitored browser with a shared chronological event timeline. Helps developers and agents debug local web app issues. CX Codex +1 859installs

From the same set77

crypto-protocol-diagram Reads protocol code or a spec and writes a Mermaid sequenceDiagram with crypto annotations, plus an ASCII diagram in the reply. CX Codex +1 3,900installs vector-forge This skill uses mutation testing to find gaps in tests for cryptographic implementations and propose vectors for uncovered cases. Use it to assess an existing test suite. CX Codex +1 3,800installs genotoxic Sorts survived mutants into false positives, missing unit tests and fuzzing targets, using a code graph built with Trailmark. CX Codex +1 3,800installs c-review Reviews native C/C++ code for memory bugs, integer overflows and races. Use it when auditing userspace applications, daemons or services. CX Codex +1 3,700installs rust-review Audits Rust crates and libraries for memory safety in unsafe blocks, FFI boundaries, concurrency bugs, and panic DoS. Useful for in-depth security reviews. CX Codex +1 2,000installs vulnerability-triage-brocards This skill assesses vulnerability reports against seven criteria, helping an agent reject weak findings, ask for evidence, or escalate a report. CX Codex +1 1,400installs trailmark-review-gate The skill runs structural security gates on branches or pull requests using Trailmark graph diffs. It flags removed auth checks, newly reachable sinks, and expanded attack surfaces. CX Codex +1 1,300installs trailmark-variant-neighborhood This skill expands a suspected vulnerability into related code locations for review. Use it before variant analysis, Semgrep, static analysis, or a manual audit. CX Codex +1 1,300installs