macOS Setup Guide
Step-by-step instructions for installing AgentOne on macOS, including fixes for common installation issues.
AgentOne runs on macOS 14.0 (Sonoma) or later, on both Apple Silicon and Intel Macs.
Install AgentOne on macOS
Download the desktop app
Head to: https://www.agent-one.dev/download
Make sure the macOS tab is selected.
- The macOS tab.
- Download Apple Silicon (.dmg) for Macs with an Apple chip (M1 or newer).
- Download Intel (.dmg) for older Macs with an Intel processor.
Click the button that matches your Mac.
Not sure which one to pick?
Click the Apple menu in the top-left corner of your screen and choose About This Mac. If the Chip field says something like Apple M1, Apple M3, or Apple M4, choose Apple Silicon. If it shows a Processor field with something like Intel Core i5, choose Intel.
If you pick the wrong one, AgentOne may not open or may run slowly. To learn more, read Apple's support article.
Open the .dmg file
When the download finishes, open the .dmg file from your browser or from the Downloads folder in Finder.
Move AgentOne to Applications
An installer window opens.
Drag AgentOne (1) onto the Applications folder (2).
Open AgentOne
Open the Applications folder and double-click AgentOne, or find it in Launchpad or Spotlight.
The first time you launch the app, macOS may ask you to confirm that you want to open an app downloaded from the internet. Click Open to continue.
Finish setup
Follow the Quickstart to sign in or connect your own AI provider.
AgentOne updates itself on macOS. See Updating AgentOne.
Troubleshooting
"AgentOne.app" was downloaded from the internet
This is a normal macOS message the first time you open many apps downloaded outside the App Store. If you downloaded AgentOne from agent-one.dev or the official GitHub releases page, click Open.
"AgentOne.app" can't be opened because Apple cannot check it for malicious software
macOS Gatekeeper may block an app until you allow it. AgentOne releases are signed and notarized, but you might still see this on some setups. To allow it:
- Try to open AgentOne once so macOS shows the warning.
- Open System Settings.
- Go to Privacy & Security.
- Scroll down to the Security section.
- Click Open Anyway next to the message about AgentOne.
- Confirm by clicking Open.
Apple notes that the Open Anyway button only appears for about an hour after you try to open the app.
"AgentOne.app" is damaged and can't be opened
This usually means the download was interrupted or modified. Try these steps:
- Delete
AgentOne.appfrom yourApplicationsfolder and delete the old.dmgfile. - Download a fresh copy for the correct chip (Apple Silicon or Intel).
- Open the new
.dmgand drag AgentOne intoApplicationsagain.
If you still see the message, you can clear the quarantine flag macOS added to the download. Open the Terminal app (press Command + Space, type Terminal, and press Return), then run:
xattr -cr /Applications/AgentOne.appThis removes the "downloaded from the internet" flag so macOS checks the app normally again.
Only run this command if you downloaded AgentOne from agent-one.dev or the
official GitHub releases page.
AgentOne asks for permissions
AgentOne only asks for macOS permissions when a feature needs them:
- Notifications when AgentOne wants to tell you a response is ready. See Agent Notifications.
- Accessibility and Screen Recording if you use Computer Use.
Other Problems
Having a different issue? Join our Discord server for live support!