Mac notes
What's specific to Murage on a Mac: Apple Silicon and Intel builds, permissions, dictation, system voices, using your screen, the built-in browser and the menu bar.
The Mac is Murage's main platform. Every feature works on a Mac, with a few differences between Apple Silicon and Intel.
Which download
There are two Mac builds:
- Apple Silicon (M-series chips), the arm64 download.
- Intel, the x64 download.
Both come as a DMG. They're signed and notarized by Apple, so macOS opens them without a warning. To check which chip you have, open the Apple menu → About This Mac.
Permissions macOS asks for
macOS asks before an app can use certain things. Murage only asks when you use the feature that needs it.
- Microphone and Speech Recognition: for dictation and calls.
- Accessibility and Screen Recording: only if you let a bot use your screen. After granting either one, restart the control session so it takes effect.
- Notifications: for alerts when a bot needs you.
If you said no by mistake, open System Settings → Privacy & Security, find the permission, and switch Murage on.
Dictation and calls
On a Mac, the microphone in the message box uses Apple's on-device speech recognition. It's free, and what you say stays on your computer. Calls use the same on-device recognition to hear you, so you see your words live.
Calls also need a voice host model and a voice, from Flux Router or your own keys. See Voice.
Built-in Mac voices
Bots can speak with the voices built into macOS. They're free and need no key. Choose Built-in Mac voices as the voice engine in Bot settings → Voice & alerts.
Letting a bot use your Mac
A bot can see and control your Mac's screen, keyboard and mouse. It's off by default.
- In the bot's Computer panel, choose This computer.
- Grant Accessibility and Screen Recording when macOS asks.
- The first time the bot wants to touch your screen, choose Allow for this bot or Don't allow. You can reset this later with Ask again.
Watching the screen doesn't give a bot control. Every action still goes through approvals. See Computers.
The built-in browser
Each bot can have its own browser inside Murage, with its own logins. You watch it work live and can take over with one click. It's an early feature: switch on Settings → Experimental → Built-in browser, then turn it on for the bot.
For a bot that needs your own signed-in Chrome, one bot at a time can use Use my Chrome. It needs Chrome 144 or later, and Chrome asks you to allow each connection.
The menu bar
Murage puts an icon in the menu bar with a count of what needs you. From it you can approve or deny ordinary requests, see what bots are doing, start New message to a bot, and Check for updates. Stop-line requests and bigger reviews open the app.
Local VM
You can also give a bot its own Linux desktop in a container on your Mac with Docker or Podman. It needs spare memory and disk. See Computers.
Memory search on Intel Macs
Smart (semantic) memory search needs a local model that isn't available for Intel Macs in this release. Intel Macs use keyword search. Everything else about memory works the same.
Backups
Backups and off-site copies work on both chips. Also back up when Murage is closed lets the daily backup run while you're signed in but the app isn't open.
Where Murage keeps things
- Your data: the
.muragefolder in your home folder. It's hidden; in Finder press Cmd+Shift+. to show hidden files. - Your encrypted keys: protected by your macOS Keychain.
See Uninstall and reset to remove everything.
Updating
Murage tells you when an update is ready. Choose Download, then Restart to update when you're ready. See Updating Murage.