docs

Buoy Web

Buoy Web lets an AI use the web for you. It clicks and types like a person. It only works in the tabs you give it. Your other tabs are left alone.

Tested on 256 web chores

3.4x faster than Claude in Chrome. 2.4x faster than ChatGPT's.

You wait less, and your AI bill is smaller.

3.4x

faster than Claude in Chrome

2.4x

faster than ChatGPT's tool

34%

of the AI cost per task done, or less

All three ran in Claude Code on Claude Haiku 5.5, with the same chores. A server checked every answer. See the whole test

Two ways to use it

Ask Buoy in ChromeYour AI coding tool
What it isA chat in Chrome's side panelClaude Code, Cursor, Codex or VS Code use Chrome for you
What you needThe Buoy Web extension and a Buoy sign-inThe Buoy MCP. The extension is best, but not a must.
CostUses AI credits. They come with paid plans.Free. No account.
Works onEvery systemMac for now

Let your AI set it up

Copy this prompt into Claude Code, Cursor or Codex. Your AI runs the setup and tells you the steps it can't do for you.

Let your coding agent set it up
Read the prompt before you paste it
Set up Buoy Web on this computer, so you can use the web for me in Chrome. Read the full instructions first: curl -fsSL https://buoy.gg/install-buoy-web.md Read the raw text, not a summary. If curl is unavailable, use any HTTP tool you have. Ask me to paste the document only if nothing can fetch it. Do the setup yourself: run the commands. Do not hand me steps you can run. Do not change this project's files, and do not commit. Ask me before anything the document does not cover. When you are done, tell me what you set up, anything that failed, and the steps only I can do: adding the Chrome extension and restarting this editor.
The prompt asks your agent to run the setup. Then it tells you what only you can do: add the extension and restart your editor.Read the setup instructions

Get the extension

Get Buoy Web from the Chrome Web Store. Click Add to Chrome.

Ask Buoy in Chrome

  1. Add the Buoy Web extension to Chrome.
  2. Go to the tab you want help with. Click the Buoy icon. The Ask Buoy panel opens on the side of that tab. Other tabs don't show it.
  3. Click Sign in with Buoy. Then approve the code on buoy.gg.

Now ask it to do something, like "Find the weather in Provo this weekend." It works in that tab and tells you what it found. Its tabs sit in a green "Buoy" tab group. The page glows green while it works.

The first time it clicks or types on a site in a chat, it asks you. Pick Always allow for sites you trust. It also asks before it clicks a button with a word like Buy, Pay, Send, Post or Delete. It finds those buttons by their words, so it can miss some. Watch what it does on sites where it can spend money.

Your rules

Open the panel's menu and pick Settings.

  • Just look: Ask Buoy can open and read pages. It never clicks or types.
  • Stop asking: it skips the site question. It still asks before it clicks a Buy, Send or Delete button. It never types passwords.
  • Always allowed: the sites it acts on without asking. Remove one any time.

Your AI coding tool

The prompt above does this for you. To do it by hand:

  1. Run this once in a terminal:

    bash
    npx -y @buoy-gg/mcp@latest init --web
    
    npx -y @buoy-gg/mcp@latest init --web
    

    It adds Buoy Web to Claude Code, Cursor, Codex and VS Code, if you have them. It works in every project.

  2. Add the Buoy Web extension to Chrome.

  3. Restart your editor.

Then ask your AI to do something on the web. When it's connected, the Ask Buoy panel's footer says "Editor bridge on".

No extension? Buoy Web still works with your AI tool. It opens its own Chrome window. Sign in to sites there once. It keeps those sign-ins in ~/.buoy/web-profile.

What it can do

Each step is a real mouse click or key press. The reply says what changed on the page. So the AI rarely needs to read the page again. That's what makes it fast.

The tools are open, read, click, type, key, wait, scroll, drag, hover, select, tabs and dialog. Your AI coding tool also gets upload and screenshot.

Safety

  • Ask Buoy only uses the tab you opened it on, plus tabs that tab opens. Your AI coding tool only uses tabs it opened. Neither one can see, switch to or close your other tabs.
  • Buoy's tabs use your Chrome profile, so they have your sign-ins. The AI can act on sites you're signed in to.
  • It never types into password boxes. It also skips code and card boxes when the site marks them. It won't send a form while one of those is empty. The AI asks you to type it on the page.
  • It treats page text as words to read, never as orders.
  • The extension only allows the Chrome calls Buoy needs. It refuses cookies, site storage and other tabs.
  • upload only sends files inside your project folder. It never sends secret files like .env or keys.
  • With your AI coding tool, your AI never waits on a step forever. After 60 seconds it stops waiting and says why.

Chrome shows a "started debugging this browser" bar while Buoy works. That's Chrome's rule for this kind of extension. If you click Cancel, Buoy stops. The AI asks before it tries again.

Where your data goes

  • With Ask Buoy, your messages and the pages it reads go to Buoy's AI service, so it can answer you.
  • With your own AI tool, they go only to that tool on your computer. Your tool may send them to its AI provider.

See the privacy policy.

If something goes wrong

  • "Chrome is closed": open Chrome. Buoy connects again by itself.
  • The panel says "Editor bridge off": run the init --web command again. Then wait a few seconds.
  • Two AI chats at once: that's fine. Each one gets its own tabs.

Usage count

Once a day, the Buoy MCP sends a random id, its version, your system type and a tag that says it's Buoy Web. It never sends web addresses, page text or what your AI did. Turn it off with BUOY_TELEMETRY=0 or DO_NOT_TRACK=1. See Telemetry.

Works on

Google Chrome. Other browsers built on Chrome, like Brave and Edge, may work. We haven't tested them yet.

We measured our speed numbers in Claude Code. Claude Code loads Buoy Web's tools up front. Other editors may load them more slowly.