@suitecut/browser-control
One API for Chromium, Firefox and the suitecut engine.
npm package 2.1.0
How it works
browser-control is a TypeScript SDK for three kinds of browser: the suitecut engine, an installed Chrome, Edge or Brave, and Firefox.
It talks to each browser over a private pipe, so there is no open debugging port.
If you have used Playwright it will read the same: contexts, pages, locators, routing, downloads and tracing, across 31 feature families. On the suitecut engine a live viewer lets a person take control from an agent and hand it back.
Your Node program uses browser-control, which drives the suitecut engine over a binary pipe, Chrome over a private CDP pipe, or Firefox over WebDriver BiDi. The suitecut engine also has a live viewer where a person can take control.
Quick start
npm install @suitecut/browser-control
Open a page in Chrome
import { launchBrowser } from '@suitecut/browser-control'
const browser = await launchBrowser({
backend: 'cdp',
executablePath: '/path/to/chrome',
})
const page = await (await browser.newContext()).newPage()
await page.goto('https://example.com')
await page.getByRole('link', { name: 'More information' }).click()
await browser.close()
What you get
- Backends suitecut engine, Chrome, Edge or Brave over CDP, Firefox over WebDriver BiDi
- Transport Private pipes; nothing listens on a port
- API Contexts, pages, frames, locators, routing, HAR, storage and tracing
- Viewer Watch live, take control, then resume the agent
- Remote Attach to a running browser, with headers and TLS client certificates
- Size About 320 KiB packed, no browser-automation dependencies
Limits
- Does not download browsers. Point it at one you have installed, or the suitecut runtime.
- Feature support differs by backend; unsupported calls fail with a clear error.
Read more
- Browser control guide Docs
- Agents Docs
- API reference Docs
Other packages
- suitecut Record, narrate and stream browser flows as finished videos
- @suitecut/shared-browser You and an AI agent in one browser window
- SuiteCut::Client Browser control from C++, any language and MCP, without Node