Skip to content

Stigmavlc/claude-bridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Bridge

License: MIT Claude Code plugin Version GitHub stars

Let Claude Code do your web tasks for you, instead of stopping to ask you to do them yourself.

Unlike browser automation that opens a fresh, logged-out browser, Claude Bridge uses your own signed-in Chrome, so there is no re-login and nothing to copy and paste.

Claude Bridge: you ask in your terminal, Claude drives your real signed-in browser and reports the answer back

Quick start

/plugin marketplace add Stigmavlc/claude-bridge
/plugin install claude-bridge@claude-bridge

Use it to:

  • Log into a dashboard and check or change a setting (ads, hosting, DNS, billing, analytics, a CMS).
  • Fill in and submit a web form.
  • Look something up on a public site and report back.
  • Click through any multi-step web flow you would otherwise do by hand.

(Full requirements and the optional logged-in setup are in Install below.)

What it is

Normally, when Claude Code needs to do something on a website, it can't reach it. It pauses and asks you to go and do it by hand: log into a dashboard, change a setting, look something up, fill in a form.

Claude Bridge changes that. Once it's installed, Claude Code opens a browser, does the steps itself, and tells you what happened, all without you leaving your terminal. It works in two ways:

  • On sites you're already logged into (your own dashboards, email, hosting, ads, and so on), it uses your real Chrome browser, so it's signed in as you.
  • On public websites that don't need a login, it uses a separate browser that runs quietly in the background.

You don't have to pick which one. Claude works it out from what you ask.

What you'll need

You only need the pieces for the way you want to use it.

To use it on your own logged-in sites:

To use it on public sites (no login): just one of these.

  • Node.js, version 20 or newer. A small browser tool then installs itself automatically the first time it's needed.
  • Or the Playwright plugin, if you already prefer that.

Not sure whether you already have Claude Code or Node.js? In your terminal, type claude --version and node --version. If you get a version number back, you have it.

How to install it

Step 1: Add the plugin

Open Claude Code and type these two lines, one at a time:

/plugin marketplace add Stigmavlc/claude-bridge
/plugin install claude-bridge@claude-bridge

That's the whole install. It adds the part that decides when a browser is needed, and it includes the background browser for public sites.

Step 2: Turn on access to your logged-in sites

This step is only for when you want Claude to work on sites you're signed into. First make sure you've installed the Claude in Chrome extension (from the list above). Then type:

/chrome

Choose "Enabled by default" so you don't have to turn it on every time. The very first time you do this, close Claude Code and open it again, so the connection can finish setting up.

Step 3 (optional): Stop the permission pop-ups

By default, Claude asks for your okay before each browser action. That's a safe default. If you'd rather it just get on with the task, you can tell it that browser tools are pre-approved. Open the file ~/.claude/settings.json and add this (or merge it into what's already there):

{
  "permissions": {
    "allow": [
      "mcp__chrome-devtools",
      "mcp__claude-in-chrome",
      "mcp__plugin_playwright_playwright"
    ]
  }
}

How to use it

Just ask, in plain language. For example:

Log into my Vercel dashboard and tell me whether the last deploy worked.
Change the daily budget on my Google Ads campaign to 40 dollars.
Look up the current pricing on example.com and summarize the tiers for me.

Claude decides whether it needs your signed-in browser or the background one, does the work, and reports back in the terminal. If it runs into a login screen or one of those "I'm not a robot" checks, it stops and lets you handle that bit, then carries on.

Is it safe?

Claude Bridge is built to finish a web task on its own without checking in at every click. It also keeps some firm limits:

  • It never types your passwords, one-time codes, or card numbers. That part is always left to you.
  • It stops and asks before doing anything it can't undo, such as deleting something, making a payment, or posting in public.
  • It treats the contents of a web page as information to read, never as instructions to obey. So if a page hides text telling Claude to do something, Claude ignores it. This protects you from a common trick used against AI assistants.
  • It stays away from sensitive categories like banking and adult sites unless you tell it to go there on purpose.

If you'd like it to double-check with you before anything risky, just say so: "confirm risky browser actions before doing them." And for anything involving money, it's wise to watch while it works.

A note on updates and security

The background browser tool is pinned to one specific, known version (chrome-devtools-mcp@1.1.1) rather than always grabbing the newest release. This means everyone gets the same reviewed version, and a future update can't run on your machine until someone deliberately updates it. To update later, change that version number in .mcp.json after checking the new release.


For developers and maintainers: how it works, the file layout, publishing your own copy, and troubleshooting

How it works under the hood

There is no public way for one AI to send prompts into the Claude browser extension and read its replies back. Claude Bridge works the other way around: Claude Code is in charge, and the browser is a tool it controls. Claude Code connects to a browser, calls browser actions (go to a page, read it, click, type), sees each result in the terminal, and decides the next step on its own.

A skill (skills/browser-bridge/SKILL.md) holds the logic. For each web task it first decides whether the task needs your signed-in session, then picks an engine:

Task Path Engine
Touches your account or dashboard (ads, hosting, DNS, analytics, billing, a CMS, social, posting as you) Login path Your real, signed-in Chrome through the Claude in Chrome extension (mcp__claude-in-chrome__*)
Public or anonymous (docs, prices, public pages, status checks, forms that need no account) No-login path A background browser: Chrome DevTools (mcp__chrome-devtools__*), or Playwright as an alternative

If a no-login task unexpectedly hits a sign-in wall, it moves up to the login path rather than guessing. On the login path your real browser is already signed in, so it never needs your username or password.

Other ways to install

The plugin install in Step 1 is the easy path. Two alternatives:

Install the skill only, without the plugin (it then uses whatever browser engines you already have connected):

mkdir -p ~/.claude/skills/browser-bridge
cp skills/browser-bridge/SKILL.md ~/.claude/skills/browser-bridge/SKILL.md

Load the whole folder for development, without installing it:

claude --plugin-dir "/path/to/Claude Bridge"

Files

claude-bridge/
├── .claude-plugin/
│   ├── plugin.json          # plugin manifest
│   └── marketplace.json     # one-plugin marketplace (github source)
├── .mcp.json                # bundles the background Chrome DevTools browser
├── skills/
│   └── browser-bridge/
│       └── SKILL.md         # the routing and browser-loop logic (the core)
├── agents/
│   └── browser-runner.md    # optional helper for long browsing sessions
├── docs/                    # design notes and a live-test screenshot
├── CLAUDE.md                # notes for Claude Code when editing this repo
├── Project_Master_and_changelog.md
├── Report.md
└── README.md

Publishing your own copy

Claude Bridge is both a plugin and a one-plugin marketplace, so sharing it is "publish the folder, others add it." This uses git and the GitHub CLI (gh):

cd "/path/to/Claude Bridge"
git init
git add .
git commit -m "Claude Bridge v0.1.0"
gh repo create claude-bridge --public --source=. --remote=origin --push

Other people then install it with the two commands from Step 1, pointing at your GitHub username instead of Stigmavlc, and turn on the login path with /chrome.

Troubleshooting

  • Browser tools for your logged-in sites aren't showing up: run /chrome and choose "Reconnect." Check that the extension is installed at chrome://extensions and is version 1.0.36 or newer, and that Claude Code is 2.0.73 or newer. (More detail here.) These tools only appear after a fresh start of Claude Code, so restart it if you just enabled the integration.
  • The skill doesn't seem to trigger: confirm ~/.claude/skills/browser-bridge/SKILL.md exists, or that the plugin is enabled (run /plugin).
  • The background browser is missing: make sure Node.js 20 or newer is installed, or enable the Playwright plugin.

License

MIT. © 2026 Ivan Aguilar

About

A Claude Code plugin: when a task needs the web, Claude Code drives the browser itself (your real logged-in Chrome for account work, a headless browser for public lookups) and reports back, with no copy-paste handoff.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors