Skip to content

Codex CLI Complete Guide

ChatGPT Atlas Installation Guide (macOS) – Download, Setup, and First Steps

ChatGPT Atlas is OpenAI’s AI-powered browser that blends agent workflows with everyday browsing. This guide walks through the macOS installation flow and key setup items. For a full feature overview, see the companion article “ChatGPT Atlas Deep Dive.”

Pre-Installation Checklist

  • Hardware: Apple silicon (M-series) Mac only2
  • Operating system: macOS 12 Monterey or later (latest point release recommended)2
  • Storage: At least 2 GB of free space to mount the DMG and copy the app bundle
  • Plans: Free / Plus / Pro / Go / Business users can install; Agent mode preview is limited to Plus / Pro / Business3
  • Network: Stable connection to download the DMG from OpenAI
  • Security: Confirm that Gatekeeper / MDM policies allow apps from identified developers

Downloading and Installing ChatGPT Atlas

  1. Visit the ChatGPT Atlas page on OpenAI’s site and click “Download for macOS.”1
  2. Open the downloaded ChatGPT Atlas.dmg, then drag the Atlas icon onto the Applications folder alias.
  3. Launch “ChatGPT Atlas” from Applications. If macOS displays a Gatekeeper prompt, choose Open to proceed.
  4. Optionally pin the app to the Dock or add it to Launchpad for quicker access.

First Launch and Sign-In

  1. Sign in with your ChatGPT account (email/password, SSO, or managed login).
  2. Decide whether to enable “Include web browsing.” The default is off, so browsing data is excluded from model training unless you opt in4.
  3. From the Atlas home screen, choose “New Task” or use shortcuts such as ⌘+K to open the agent command panel and confirm basic navigation.
  4. Open Settings > Memory to toggle memory usage or clear stored context. Align the default with your personal or organizational policy.

Configuring Agents and Extensions

  • Agent mode is in preview for Plus / Pro / Business subscriptions; Free / Go accounts can browse but cannot launch agents3.
  • Agents operate within page visibility and permission guardrails; they cannot run arbitrary code, download files, install extensions, or access stored passwords6.
  • Use the Extensions panel to install essentials from the Chrome Web Store. Many extensions work, but those requiring nativeMessaging or deeper hooks may be unsupported or unstable5.
  • Customize themes, dark mode, and focus layouts in Preferences > Appearance to match existing workflows.

Common Troubleshooting Scenarios

  • Installer won’t run: In System Settings > Privacy & Security, allow ChatGPT Atlas when Gatekeeper prompts appear.
  • Intel Mac not supported: Atlas currently targets Apple silicon Macs only2.
  • Agent mode missing: Verify that the account has Plus / Pro / Business access and check release notes for preview availability3.
  • Extensions misbehave: Confirm they are enabled inside Atlas and review whether they rely on unsupported native messaging interfaces5.
  • Enterprise policy controls: Dedicated SSO enforcement, SCIM provisioning, and audit log exports are not yet available. Use MDM or existing tooling to control deployment7.

November 2025 Distribution Checklist

ItemCommand / ActionPurpose
Verify DMG hashshasum -a 256 ChatGPT\ Atlas.dmgEnsure the download is intact
Check bundle versiondefaults read /Applications/ChatGPT\ Atlas.app/Contents/Info CFBundleShortVersionStringConfirm the auto-updated build
Validate code signaturecodesign --display --verbose=2 /Applications/ChatGPT\ Atlas.appEnsure the Team ID belongs to OpenAI1
Backup preferencestar czf ~/Desktop/atlas-prefs-$(date +%Y%m%d).tgz ~/Library/Application\ Support/com.openai.chatgpt.atlasPreserve agent/extension state

Known caveats (Nov 2025)

  • If the Agent tab disappears after an update, remove ~/Library/Preferences/com.openai.chatgpt.atlas.plist (after taking a backup) and sign in again.
  • When Chrome extensions crash immediately, add ones that do not rely on nativeMessaging first and verify support via the official compatibility list5.
  • Store Sora / Whisper prompt templates captured inside Atlas under analysis/<date>/atlas/ (outside Git) and log the path in TodoWrite so other agents can reuse it.

3-step playbook for Intel Mac users (Nov 2025)

Atlas still officially requires Apple silicon2. Intel Macs cannot run the DMG directly, so follow this diagnostics → remote host → sync workflow.

1. Confirm hardware + SIP status

uname -m                                   # x86_64 indicates an Intel Mac
sysctl -n machdep.cpu.brand_string         # Capture the CPU model (audit log)
csrutil status                             # Ensure System Integrity Protection is enabled
  • If uname -m returns x86_64, skip local installs and plan to remote into an Apple silicon host.
  • Re-enable SIP if it reports disabled before opening any remote screen-sharing session.

2. Remote into an Apple silicon machine

  1. Provision access to a Mac mini/Mac Studio via MacStadium, AWS EC2 Mac, or an internal lab.
  2. Install Atlas on that machine, then tunnel the UI back to the Intel Mac:
ssh -L 5901:localhost:5901 user@silicon-host.example
open vnc://localhost:5901    # Use Screen Sharing to operate Atlas
  1. Save transcripts and screenshots under analysis/<date>/atlas_remote/ on the Intel Mac and link them inside TodoWrite for traceability.

3. Mirror DMGs and preference files

# Copy the latest DMG to the remote Apple silicon host
rsync -avh "~/Downloads/ChatGPT Atlas.dmg" user@silicon-host.example:~/Downloads/

# Sync Atlas preference files (extensions, memory settings, etc.)
rsync -avh ~/Library/Application\ Support/com.openai.chatgpt.atlas \
           user@silicon-host.example:~/backups/atlas-prefs/
  • Re-run shasum -a 256 on the remote copy before mounting the DMG.
  • After each remote auto-update, capture defaults read /Applications/ChatGPT\ Atlas.app/Contents/Info CFBundleShortVersionString so the Intel-side runbook stays current.

What to Do Next

  • Learn productivity workflows and safety guardrails in the “ChatGPT Atlas Deep Dive.”
  • OpenAI plans Windows, iOS, and Android releases; this guide will be updated as new platform installers ship.