MiraBridge Desktop is a first-class local runner for agent work. It connects directly to the shared MiraBridge Gateway and does not require VS Code to be installed, connected, or running.
Use Desktop when you want a full-screen control center for agent chat, workspace context, terminal execution, patch review, approvals, and mobile handoff from a native app.
Download
Download the current public beta build:
| Platform | Artifact | | -------- | -------- | | macOS Apple Silicon | Download DMG | | Windows x64 | Download installer |
The Desktop app connects to the production Gateway by default:
https://api.mirabridge.io
wss://api.mirabridge.io/wsRequirements
- A MiraBridge account
- macOS Apple Silicon or Windows x64
- A local workspace folder you want the agent to inspect or modify
- Git installed for repository operations
- Project toolchains installed locally when you expect the agent to run them, such as Node.js, pnpm, Python, Rust, Xcode, or Docker
Desktop, VS Code, mobile, and Codex Bridge are separate clients over the same Gateway brain. Each surface owns its own lifecycle, session state, conversation scope, and workspace context.
Install on macOS
- Download the macOS DMG.
- Open the DMG and drag MiraBridge Desktop into Applications.
- Launch MiraBridge Desktop.
- Sign in with your MiraBridge account.
- Open a workspace folder from the Desktop app.
If macOS asks for confirmation because this is a beta build, approve the launch from System Settings. The notarized public artifact is intended for normal first-install testing.
Install on Windows
- Download the Windows x64 installer.
- Run the installer.
- Launch MiraBridge Desktop from the Start menu.
- Sign in with your MiraBridge account.
- Open a workspace folder from the Desktop app.
The current Windows artifact is unsigned. Windows SmartScreen may show an extra confirmation prompt during beta installation.
Verify the Connection
After sign-in, Desktop should show an active Gateway connection and an open workspace. A working setup has three parts:
| Check | Expected result | | ----- | --------------- | | Account | Your MiraBridge user is signed in | | Gateway | WebSocket connection is active | | Workspace | A local project folder is selected | | Tools | File, terminal, and git operations can request approval and execute locally |
First Desktop Session
Try a small read-only prompt first:
Summarize this repository structure and identify the main app entry points.Then try a terminal-safe prompt:
Run the project's test discovery command and tell me which test suites exist.Desktop will route the request through the Gateway, show approval when execution is needed, run approved tools against the selected workspace, and stream results back into the conversation.
Next Steps
- Desktop Agent Workflows - understand sessions, workspace context, and mobile handoff
- Terminal Commands - learn how command execution works
- Approvals & Security - configure a safe approval workflow