Set up Braus and give your first worker a job.

Start in the Braus app, or connect Claude Code or Codex over MCP. Give the agent a small desktop task and check the result yourself.

Download for macOS MCP and agents

claude mcp add --scope user --transport stdio braus -- \
  "/Applications/Braus.app/Contents/Helpers/braus-bridge" \
  mcp-bridge --connection \
  "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"

codex mcp add braus -- \
  "/Applications/Braus.app/Contents/Helpers/braus-bridge" \
  mcp-bridge --connection \
  "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"

{
  "mcpServers": {
    "braus": {
      "command": "/Applications/Braus.app/Contents/Helpers/braus-bridge",
      "args": [
        "mcp-bridge",
        "--connection",
        "/Users/YOUR_USERNAME/Library/Application Support/Braus/MCP/CLIENT_UUID.connection.json"
      ]
    }
  }
}

Choose how you use Braus

In the Braus app

Create a worker, connect a provider and follow messages and tool activity in one workspace.

Mac: macOS 15 or later
Sign-in: Your Forte account

Get started

With Claude Code or Codex

Connect Claude Code or Codex to Braus’ desktop tools over MCP.

Transport: Local STDIO
Helper: braus-bridge, inside Braus.app
Hosted endpoint: None

Set up an MCP client

Open source edition

The open source edition of Braus is under Apache 2.0: its app, the engine and the background driver.

License: Apache 2.0
Sign-in: None

Open source edition on braus.ai and GitHub

Guides

Start

Get started

Give the agent a small desktop task and check the result yourself.

Permissions & data

macOS access and the authorization of each action are separate controls.

Use Braus

Workspace

Configure a worker, give it a task and follow its conversation.

Models & MCP

Desktop access is configured separately from the model connection.

MCP and agents

Set up an MCP client

Braus exposes its bridge over local STDIO, so the client and Braus run on the same Mac.

Configure your client

No URL, API key, OAuth login or environment variable is needed for this bridge.

Choose capabilities

Desktop apps and Browser are selected by default when you create a grant; Passive Watcher and shared memory need an explicit selection.

Test the MCP connection

Confirm that the client actually calls Braus’ tools and returns their results.

Several clients, stopping access

Each Braus grant accepts one active connection at a time, including connections opened for tool discovery.

Troubleshoot an MCP client

Braus must be running, the grant enabled and the connection-file path correct.

Technology

Background

A worker uses apps on a display of its own, off your screen, while you keep using your Mac.

Perception

Perception turns an observed window into structured context for an agent.

Memory & Brain

Memory stores what the engine learned about how an app works.

Architecture

The engine reads the window as text, acts on the seat and verifies the effect.