Installation

Agent Browser is private. Consume it through GitHub Packages so every repo gets normal package-manager behavior: semver pins, lockfiles, repeatable CI installs, and simple rollbacks.

Package

@cmmd-center/agent-browser

Registry Setup

Add this to the consuming repo’s .npmrc:

@cmmd-center:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

For local development, set GITHUB_TOKEN to a GitHub token that can read private packages for CMMD-Center. Do not commit a real token. In GitHub Actions, use the workflow GITHUB_TOKEN when it has package access, or store a read-only package token in repository secrets.

Install

Use the package manager already used by the consuming repo:

npm install @cmmd-center/agent-browser
pnpm add @cmmd-center/agent-browser
bun add @cmmd-center/agent-browser

Update

npm update @cmmd-center/agent-browser
pnpm update @cmmd-center/agent-browser
bun update @cmmd-center/agent-browser

For production integration branches, pin a published package version in the lockfile. Do not leave Forge or another production repo pinned to a moving Git branch.

Optional Peers

The root import is intentionally light. It does not require Playwright.

Install optional peers only when the consuming app imports the matching subpath:

pnpm add playwright
pnpm exec playwright install chromium

pnpm add express zod

Use Playwright for @cmmd-center/agent-browser/playwright or CDP-backed automation. Use express and zod when hosting the HTTP server.

Import Map

Import	Use
@cmmd-center/agent-browser	Core runtime, controller, safety, events, stores, and shared types.
@cmmd-center/agent-browser/client	HTTP client for agent tool routers.
@cmmd-center/agent-browser/server	HTTP server routes for browser tools and preview/debug workflows.
@cmmd-center/agent-browser/host	Host bridge for app-owned browser sessions.
@cmmd-center/agent-browser/embedded	Embedded backend transport.
@cmmd-center/agent-browser/embedded-host	In-process embedded host contract.
@cmmd-center/agent-browser/playwright	Playwright backend.
@cmmd-center/agent-browser/cdp	CDP backend.
@cmmd-center/agent-browser/extension	Chrome extension transport backend.
@cmmd-center/agent-browser/adapters/electron	Electron IPC adapter.
@cmmd-center/agent-browser/adapters/tauri	Tauri command adapter.

Quick Check

import { AgentBrowser, createAgentBrowserRuntime } from "@cmmd-center/agent-browser";
import { AgentBrowserHttpClient } from "@cmmd-center/agent-browser/client";

If that compiles without importing Playwright, the consuming repo is using the package boundary correctly.