@suitecut/shared-browser
You and an AI agent in one browser window.
npm package · preview 0.1.0 preview
How it works
Most agent browsers run where you cannot see them. shared-browser opens one real window with suitecut’s own tabs and toolbar.
The agent works in the same tabs you can see, click and type in.
Connect any MCP client, or drive it from TypeScript. Commands go over the browser’s own input and DevTools runs inside the process, so there is no port for anything else to find. Permission prompts and dialogs wait for you, or for the agent if you let it answer.
You and an agent use one browser window. You click and type in it; the agent reaches it through the MCP server. There is no debugging port for anything else to attach to.
Quick start
npx -y @suitecut/shared-browser --executable /path/to/suitecut-browser
Add it to your MCP client
{
"mcpServers": {
"shared-browser": {
"command": "npx",
"args": ["-y", "@suitecut/shared-browser"],
"env": { "SUITECUT_SHARED_BROWSER": "/path/to/browser" }
}
}
}
Or drive it from TypeScript
import { launchSharedBrowser } from '@suitecut/shared-browser'
const browser = await launchSharedBrowser({ executablePath })
const tab = await browser.activeTab()
await tab.goto('https://example.com')
console.log(await tab.snapshot()) // text and controls with refs
await tab.fillRef('e3', 'Ada Lovelace')
await tab.clickRef('e4') // you can keep using the window
What you get
- Window suitecut’s tab strip and toolbar; every tab a full Chromium page
- MCP 19 tools over stdio: navigate, snapshot, click, type, tabs, dialogs
- SDK launchSharedBrowser() with tabs, refs, input, events and screenshots
- Input Trusted events, so pages see a person, not a script
- Detection sannysoft, CreepJS, BrowserScan, incolumitas and BotD saw a normal browser
- Prompts Allow and Block in the toolbar; dialogs wait for an answer
Limits
- Preview: macOS on Apple silicon only, and the API may change before 1.0.
- The window is on screen; there is no headless mode.
- Not tested against commercial bot protection such as Cloudflare or DataDome.
Read more
- Package README GitHub
- Control protocol GitHub
Other packages
- suitecut Record, narrate and stream browser flows as finished videos
- @suitecut/browser-control One API for Chromium, Firefox and the suitecut engine
- SuiteCut::Client Browser control from C++, any language and MCP, without Node