Skip to Content
AdunemDocs
GuidesCLI referenceHelp

Browser extension

Chat with your agents in a Chrome side panel and let them read and act in your tabs, with clear rules about what they can do on their own.

The Adunem extension adds a side panel to Chrome. In it you chat with your own Claude Code or Codex, with any agent of yours, or with an agent someone shared with you, and the agent can work in your tabs: read the page, fill in a form, click, move between pages. The agent and its model run on the owner's computer, on the owner's own plan. The extension reads the page and carries out what the agent decides, after checking it against the rules below.

Set it up

Install the extension

Add Adunem to Chrome, then pin it and select its icon to open the side panel.

Sign in

Select Sign in. A tab opens on the website and shows a code: check that it matches the one in the panel, then approve this browser. It now appears under Devices, where you can revoke it at any time.

Connect an agent

If you have no agent online yet, the panel shows how to connect your Claude Code or Codex. Install the CLI and run adunem link claude-code (or codex) in a terminal. See Connect Claude Code or Codex. The panel opens the agent as soon as it is online.

Work with an agent in your tabs

Pick an agent from the menu in the panel's header. It lists your agents and the agents shared with you, shows whether each is online, and for your own Claude Code or Codex it shows how much of your plan's usage is left.

Type what you want, for example "Summarize this page" or "Find the cheapest option on this page", and send it. An agent that can browse works in the tab you are on, so there is nothing to switch on first. While it works, the panel folds its steps into one line you can open, and a glow on the page shows what it is touching. Select Stop at any time.

  • Each tab group is a chat of its own, like Claude in Chrome. If the panel is open on a tab outside Adunem's groups, it offers Open chat to go back to yours or New chat here to start another.
  • Claude Code and Codex keep each chat's history themselves, so a long chat is not forgotten after a few turns. Type /compact to summarize one.
  • Attach up to five files with the paperclip. The agent sees only their names and sizes, and always asks before putting one into a page.
  • Type / in the message box to see the other commands: /clear, /mode, /model, /usage, /history and /settings.
  • Chats are saved only in this browser, in the History view, which has a Clear button.

The text of a page you lend goes to the agent, on its owner's computer. Only use agents you trust on pages with private information. With an agent that is shared with you, that computer is not yours.

What an agent may do on its own

You choose how much freedom the agent has. The setting is in a menu under the message box, in Settings under Permissions, or with /mode ask and /mode act.

Ask before acting (default)Act without asking
Typing, scrolling, links on the same siteRunsRuns
Submit, send, save or sign up, and Enter in a formAsksRuns
Going to another websiteAsksRuns
Changing a spreadsheet cell, shortcuts that save, send, cut, paste or delete, drag and dropAsksRuns
Putting one of your attached files into a pageAsksAsks
Payments and deletes: pay, buy, checkout, delete, transferAsksAsks
Password and card fieldsNever read or filledNever read or filled
Blocked sitesNot touchedNot touched

When the agent needs your answer, a card appears in the panel with Allow, Deny and, for the checks that ask in Ask before acting mode, Allow for this task. Payments, deletes and uploads ask every time, even after Allow for this task. If you limited the extension's site access in Chrome, the panel asks once for a site, with Only this site or Allow on all sites.

These checks run inside the extension. They never depend on the model, so a clever page or a confused agent cannot talk its way past them. They apply to every agent, your coding agents too.

Blocked sites

Agents never act on blocked sites. The list starts with banks (*bank*), PayPal, Venmo, Wise, Revolut, Coinbase, Binance, Kraken and Stripe. Edit it under Blocked sites in the extension's settings: one pattern per line, where * matches anything.

Other settings

Open the extension's Settings from the panel's gear. Besides Permissions, Coding agents and Blocked sites, there is an Account section with Sign out.

  • Real keyboard and mouse is for pages that ignore simulated input, such as spreadsheets and editors. When a click or typing does not seem to work, the extension repeats it with real input through Chrome's debugger, and Chrome shows a "debugging this browser" bar while it does. You can turn it off.
  • Steps per request limits how many steps an agent that reads the page one step at a time can take. For a shared agent, each step counts as a call.

Use your browser from Claude Code or Codex

Linking a coding agent also gives it browser tools in the terminal. adunem link registers an adunem-browser tool set alongside the room tools, so Claude Code or Codex can read pages, find elements, click, type and take screenshots in any project, in the browsers you are signed in to, on this computer or another one.

Coding agents work in a window and tab group of their own, never in your tabs. The same rules from the table apply, and the browser asks you before anything that matters. To let them in, keep Let my coding agents use this browser on under Coding agents in the extension's settings. It shows whether the browser is connected.

For another tool that speaks MCP, run the tools yourself as a stdio MCP server:

adunem browser-mcp

Next steps

On this page