AtlasGetting started
Install, grant a couple of permissions, and start telling Atlas what to do.
1 · Install
- Download the build for your OS from the download page and unzip it.
- macOS: drag Atlas.app to Applications, then right-click → Open the first time. Windows: run Atlas.exe; on the SmartScreen prompt choose More info → Run anyway.
- Add an API key in Settings — a free Gemini key works great; add an Anthropic key to use Claude.
Permissions
macOS needs Screen Recording and Accessibility (System Settings → Privacy & Security) so Atlas can see the screen and control input. Windows works out of the box; the global hotkey may ask for input access.
2 · Talk to it
Type or speak what you want — "find the cheapest flight to Tokyo next month and screenshot it", "clean up my desktop", "why is my Wi-Fi dropping". Atlas screenshots, reads the screen, and acts. Press Ctrl/Cmd + Shift + Space to summon it from anywhere.
Slash commands
| /voice | Toggle hands-free voice chat |
| /remote | Start Atlas Link (control this computer from your phone) |
| /manual | Bridge an external AI for a hard step |
| /windows | List open windows |
| /update | Install the latest Atlas version |
| /clear | Clear the chat |
| /forget | Wipe saved facts |
| /help | Show all commands |
3 · Atlas Link — drive it from your phone
Run /remote (or enable "start automatically" in Settings). Atlas prints a URL + PIN — open the URL on a phone on the same Wi-Fi, enter the PIN, and you get a live mirror of your screen with a trackpad, keyboard, full-screen mirror, and a chat tab that tells Atlas what to do. The PIN is stable, brute-force throttled, and stays on your LAN.
4 · Updates
Atlas checks for a newer release on launch and offers to install it — or run /update any time. Updates are downloaded, checksum-verified, and swapped in place with a rollback backup, then Atlas relaunches. Toggle it in Settings → Performance → Automatically check for updates.
5 · Troubleshooting
macOS: "Atlas can't be opened"
It's open-source and not notarized, so Gatekeeper asks once. Right-click the app → Open → Open. Updates afterward don't re-prompt.
It can see the screen but won't click
On macOS, grant Accessibility (not just Screen Recording) and reopen Atlas. On Windows, make sure no other app is blocking simulated input.
Glass looks dark instead of blurred
Toggle Liquid Glass in Settings → Appearance. The native blur is on by default; if a macOS/Windows version misbehaves it falls back to a frosted style automatically.
The hotkey doesn't work
macOS: grant Input Monitoring + Accessibility. Windows: another app may have claimed the same combo — change it in Settings → Performance.