Getting Started

Install BridgeMind One on macOS 26, sign in, choose Agent, Code, or Chat mode, and start shipping with an AI teammate.

This guide takes you from download to your first useful session in BridgeMind One.

What You Need

• A Mac running macOS 26 or later
• A BridgeMind account entitled to BridgeMind One
• An internet connection for sign-in, hosted AI work, plugins, and transcription
• Claude Code or Codex installed for Agent and Chat conversations

Step 1: Install BridgeMind One

1. Download the latest universal DMG.
2. Open the DMG and move BridgeMind to your Applications folder.
3. Open BridgeMind from Applications. The installed app uses the shorter name, while the product remains BridgeMind One.
4. If macOS asks you to confirm an app downloaded from the internet, review the prompt and choose Open.

BridgeMind One checks for signed updates from inside the app, so you do not need to repeat the installation process for each release.

Step 2: Sign In

Select Sign In. BridgeMind One opens your browser to complete authentication, then returns you to the app.

If your account is not entitled to BridgeMind One, the app shows the upgrade screen before loading your workspace.

Step 3: Choose a Mode

Use the mode switcher in the title bar:

• Agent — Create a persistent teammate for a role or responsibility.
• Code — Open a folder and work with terminals, files, browsers, and coding agents.
• Chat — Start a conversation that is not attached to a teammate or project.

You can switch modes at any time. Each mode keeps its own navigation, and saved agents, workspaces, and chats remain available when you return.

Step 4: Start Your First Session

Create a teammate

Open Agent, select New Agent, and provide:

1. A clear name, such as Release manager or Research partner
2. A brief that defines the teammate's job, standards, and boundaries
3. Claude Code or Codex as its chat engine

Start a chat and assign one concrete outcome. The teammate can build memory and reusable skills as you continue working together.

Open a code workspace

Open Code, add a project folder, and start a terminal or agent thread. BridgeMind One detects supported third-party coding-agent command-line apps already installed on your Mac; it does not bundle them.

Start a standalone chat

Open Chat, create a conversation, choose Claude Code or Codex, and send your prompt. Use this mode when the work does not need a project folder or a persistent teammate.

Step 5: Enable Dictation

Dictation is optional. To dictate into other apps, BridgeMind One needs:

• Microphone permission to capture your speech
• Accessibility permission to observe the Fn gesture and paste the transcription into the focused app

Grant both in System Settings → Privacy & Security, then enable Fn push-to-talk in BridgeMind One Settings. Dictation uploads audio to BridgeMind's hosted Together Whisper transcription service; it is not an offline mode.

See Dictation for gestures, audio handling, and troubleshooting.

A Strong First Prompt

Describe the outcome, context, constraints, and finish line:

Review this project, identify why the build fails, make the smallest safe fix, run the relevant checks, and summarize exactly what changed.

Keep decision authority explicit. Ask the agent to stop before external publishing, spending, deletion, or another action you want to approve yourself.

Next Steps

• Create a focused teammate in Agent Mode.
• Build in a project workspace with Code Mode.
• Connect approved services through Skills and Plugins.
• Schedule repeatable work with Routines.