Start

Get started

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.

Platform: macOS
Entry: Braus app or MCP
Runtime: On your Mac

What you need

Prepare	Check
Mac	macOS 15 or later. Compatibility lists the validated configuration.
Sign-in	The Braus app from this site works with a Forte sign-in. The open source edition on GitHub needs none.
Provider	Use Claude Code or Codex, or connect a supported model in Braus, including Gemini or Ollama. Desktop tool use depends on the model. See Models & MCP for connection requirements.
Desktop access	The three macOS permissions, asked on the first launch and again under Settings → Computer → This Mac. Review what each one allows before granting it.

Choose how you use Braus

Braus runs AI agents in desktop apps on your Mac. Create a worker in the Braus app, or connect Claude Code or Codex over MCP; the MCP guide also covers other local clients.

In the Braus app

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

Open the workspace guide

With Claude Code

Connect Claude Code to Braus’ desktop tools over MCP.

Set up the connection

With Codex

Connect Codex to Braus’ desktop tools over MCP.

Set up the connection

Install and connect

Braus app

Download Braus for macOS, open it and sign in when it asks. In the app, choose Create Worker, Connect Provider… and Allow Mac Access… in that order.

Claude Code or Codex

Keep Braus open on the same Mac as the client.
In MCP → MCP Connections…, name the client, select its capabilities and click Add Client.
Turn Enabled on and wait for Ready.
Under Client configuration, copy the Claude Code or Codex command and run it in Terminal.
Start a new client session, so it discovers Braus’ tools.
Run the read-only first check: permission status, running apps and their windows, without changing anything.

MCP and agents has the full setup, the templates for other local MCP clients and the first-check prompt.

Download

The Download on this site is the Braus app. It works with a Forte sign-in, and these guides describe it. The open source edition comes as a DMG from its GitHub release, and its README covers it. Compatibility lists the requirements. The MCP steps follow the setup guide checked on October 6, 2026; MCP and agents states its scope.

Run a small task

Open the app and the window you want the agent to use. Use a test document for your first run. Then run a small task:

Name the app and the intended result. Specify the document or window and what should change.
Set a boundary. Say what the agent should leave untouched and where it should stop.
Follow the activity. Read tool results as the worker progresses. A connected model alone does not confirm desktop access.
Check the app. Compare its final state with your request before continuing.

Example request: adapt the app and document to your task

In the open test document, change the heading to “Project notes”.
Leave the body text unchanged. Stop before saving.

Check the result

A reply saying “done” is not enough. Check the action evidence and the current app state.

If you see	Do this
Confirmed change	Compare the observed change with the requested result.
Uncertain effect	Inspect the window before retrying. Input may already have taken effect.
Unavailable target	Open or identify the intended window, then request a fresh observation.
Action not admitted	Check permissions, session ownership or the reported window state before continuing.

These are plain-language categories. The tools report found_acted, acted_unverified, acted_noop, ambiguous, honest_miss and refused; Background explains each one, and Workspace explains messages and events.

Compatibility

Braus is built for macOS 15 or later. The desktop seat has been validated on one configuration so far: macOS 27.0, build 26A5425a, on a MacBook Pro with Apple M4 (Mac16,1). On any other build the app still works and shows Seat: Not Validated under Settings → Computer → This Mac, recording that status with each action.

Troubleshooting

Use Workspace for workers, conversations and Stop. Use Models & MCP for connection issues. Use Permissions & data for the macOS grants and where files live.

For the underlying system, read Perception for window-to-text, Memory & Brain for learned app knowledge, Background for the desktop seat and Architecture for the full execution path.

Verified source

Checked against Braus app source at main 524eb7f on October 1, 2026. UI labels and paths have not yet been checked against the Braus build downloaded from this site.