SuiteCut::Client
Browser control from C++, any language and MCP, without Node.
C++20 library and C ABI archives per platform
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.
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
find_package(SuiteCutClient CONFIG REQUIRED)
Give an agent three tools
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
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
- Native SDK guide GitHub
- Agents Docs
- Performance Docs
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/shared-browser You and an AI agent in one browser window