Quickstart

Get MiraBridge running in under 5 minutes. Choose your platform below to get started.

Prerequisites#

Before you begin, make sure you have:

• A MiraBridge account (sign up at mirabridge.io)
• MiraBridge Desktop for standalone agent work, or VS Code 1.85+ for the extension
• iOS 16+ or Android 12+ (for the mobile app)

Installation#

Desktop App#

MiraBridge Desktop is the fastest way to run the agent without depending on VS Code.

1. Go to Download
2. Download MiraBridge Desktop for macOS or Windows
3. Sign in with your MiraBridge account
4. Open a workspace folder
5. Start an agent conversation

Direct beta artifacts:

• macOS Apple Silicon: Download DMG
• Windows x64: Download installer

VS Code Extension#

1. Open VS Code and go to the Extensions panel
2. Search for MiraBridge
3. Click Install
4. Sign in with GitHub or Google when prompted

# Or install from the command line
code --install-extension mirabridge.mirabridge

Mobile App#

Download from your app store:

• iOS: Download on App Store
• Android: Get it on Google Play

Sign in with the same account you used for VS Code.

Codex Bridge#

If you use OpenAI Codex CLI, install the bridge:

npx @miratech/codex-bridge connect

Verify Connection#

After signing in on any client, you should see a green connection indicator. Desktop and VS Code each own their own local workspace session; the Gateway syncs messages, approvals, and status across connected devices in real-time.

For Desktop, verify that:

• A workspace folder is open
• The Gateway WebSocket is connected
• Tool approvals appear when the agent wants to edit files, run commands, or operate git

Next Steps#

• Core Concepts — understand how MiraBridge works
• Desktop Installation — standalone runner setup
• Your First Session — complete walkthrough