SuiteCut::Client

Browser control from C++, any language and MCP, without Node.

C++20 library and C ABI archives per platform

SuiteCut::Client, explained. Recorded, narrated and rendered by suitecut.

How it works

SuiteCut::Client is a C++20 library with a versioned C ABI. It drives the suitecut engine, an installed Chrome or Chromium, or Firefox, with no Node.js, no CEF headers and no automation library.

Three agent tools: observe, act and wait.

Its suitecut-native-control CLI keeps a browser session alive between shell commands, and runs as an MCP server with 53 driver tools for agents that want more than three.

C++ appC++20 headersany languagethrough the C ABIMCP clientor a shell scriptnative-controlCLI and MCP serverSuiteCut::Clientno Node, no CEFheaderssuitecut engineChromeCDP pipeFirefoxWebDriver BiDi

A C++ app, any language through the C ABI, or an MCP client through the native-control CLI all use SuiteCut::Client, which drives the suitecut engine, Chrome or Firefox.

Quick start

CMake
find_package(SuiteCutClient CONFIG REQUIRED)

Give an agent three tools

C++
suitecut::AgentDriver driver(browser);
suitecut::SimpleAgent agent(driver);

auto seen = agent.call("observe", {{"format", "compact"}});
auto done = agent.call("act", {
    {"action", "fill"}, {"ref", "e1"}, {"value", "Ada"}});
auto ready = agent.call("wait", {
    {"text", "Saved"}, {"timeoutMs", 2000}});

Or use the CLI

Terminal
alias sc='suitecut-native-control --session shop'

sc --browser /usr/bin/chromium open https://example.com
sc snapshot
sc fill e12 'Ada'
sc click e15

suitecut-native-control --browser /usr/bin/chromium \
  --mcp --tools core,network

What you get

  • Library C++20 headers and a stable, versioned C ABI, static or shared
  • Agent tools observe, act and wait; up to 64 actions in one act
  • Refs Short element refs, replaced on every observation; stale refs are rejected
  • Safety Mutations are never retried; password values are redacted
  • CLI Named sessions that stay alive between commands
  • MCP 53 driver tools in groups: core, network, state, debug and media

Limits

  • Linux and macOS on Apple silicon are qualified separately. Windows is not packaged.
  • Safari and WebKit are not supported.

Read more

Other packages

Next: suitecut