Install

Install the CLI

npm install -g bureau-sh

The binary is bureau.

Heads up — publish pending. bureau-sh is not published to npm yet; the publish pipeline is a pending step. Inside this monorepo the package is @agstudio/bureau and is run from source (pnpm --filter @agstudio/bureau build, then bureau …). Once the public package ships, npm install -g bureau-sh is the one-liner.

Requirements

• macOS. The default credential store shells out to the security CLI (macOS Keychain), and the screen tools (screen_*) are macOS-only. No other backend is wired yet.
• Node.js ≥ 22.13.0 — Bureau's stated engine floor.
• Camofox — the stealth Firefox serve process. Bureau talks to it over CAMOFOX_URL (default http://127.0.0.1:9377). It is not downloaded for you; install it separately and make it launchable (below).

Camofox

bureau start will launch Camofox for you, but it needs a way to start it — Bureau does not fetch the browser on first run. It resolves a launch command in this order:

1. --camofox-cmd "<cmd>" passed to bureau start.
2. CAMOFOX_SERVE_CMD in the environment (e.g. CAMOFOX_SERVE_CMD="camoufox serve").
3. macOS launchd: launchctl start com.agentik.camofox.

If none resolves, bureau start exits with an explicit error telling you to set CAMOFOX_SERVE_CMD or pass --camofox-cmd. You can also run Camofox yourself on :9377 and start Bureau against it with bureau start bureau-only.

# Example: point Bureau at a camoufox you can serve yourself
CAMOFOX_SERVE_CMD="camoufox serve" bureau start

Verify

bureau --version        # prints the installed version
bureau --help           # top-level command list

Next: Quickstart.