Set Up Your Mac

Written & tested for accuracy by a developer (not AI) · Updated October 2026

Full Mac Setup

What you get if you keep going in the "Set Up Your Mac" apps. The optional steps that set up your Mac, what each one adds, and why it is useful.

Each "Set Up Your Mac" app sets up one thing first, such as AI apps, Python, Homebrew, or the command line, and checks that it works. Then it asks whether you want to keep going. This page explains what additional screens offer, which are valuable extras.

These steps are part of the full Mac setup roadmap.

The "Keep going?" screen

After the app sets up the tool you came for and checks that it works, it asks if you are ready for more. The headline names what is ready, such as "Python is ready" or "Homebrew is set up". The screen has two buttons:

  • Keep going - moves on to the optional steps described below.
  • Finish here - goes to the app's last screen, which lists what was set up. Everything the app installed stays on your Mac.

You can come back at any time and run the app again. It checks your Mac, skips everything already set up, and shows the "Keep going?" screen again, if you missed something and you want it later.

How the optional steps work

Each optional step is one screen with a "Skip" button. Nothing is installed until you click a button that installs it, so you can take only what you want. Where a screen lists several apps, apps already on your Mac are grayed out. A step you've already completed is skipped, so on a second run you'll see only what is left.

The app installs apps and tools from their makers, mostly with Homebrew, the package manager many developers use.

The steps after "Keep going"

Here's what the screens offer. The order differs a little from app to app. Each item links to a topic page that explains the step in detail.

  • Claude - Claude Desktop, Anthropic's app for chat and for Claude Code in an ordinary app, and the Claude Code command-line tool for the terminal. An AI agent such as Claude Code reads your files, writes code, and runs commands while you describe what you want in plain words. See the article Install Claude Code on Mac.
  • ChatGPT and ChatGPT Codex - OpenAI's ChatGPT desktop app, which includes ChatGPT Codex, OpenAI's AI coding agent, and the codex command-line tool for the terminal. Many developers use both Claude Code and ChatGPT Codex. See the article ChatGPT for Mac.
  • An example project - a practice folder to open with an AI agent, with instruction files that tell the agent how to work there. If you said you have coding experience, you also get an example coding project. See the article Starter Projects.
  • Skills - saved sets of instructions that give an AI agent a repeatable job, such as cleaning up text that sounds machine-written. See the article Agent Skills.
  • A web-reading connector - an MCP server (a connector between an AI agent and another service) that fetches web pages as clean text. Without one, an AI agent often gets raw page code or a blocked page. If you said you work on a team, the next screen offers connectors to workplace tools. See the article MCP Servers (Connectors).
  • A code editor - an app for reading and writing code, which shows the files in a project and what changed in each one. A project editor like Yaxed is often enough when an AI agent writes the code, but a code editor helps developers who write code themselves. The screen offers several well-known editors. Install one or none.
  • A knowledgebase - a collection of notes kept as Markdown files that link together, which an AI agent can read and add to. The screen offers the AI-Knowledgebase example project, a research wiki an AI agent keeps for you, and two knowledgebase apps (personal knowledge managers, or PKMs). Take any of them or none. See the article Knowledgebases for AI.
  • Programming languages - Python, JavaScript, Java, Ruby, and Rust. The app installs Python with uv, and JavaScript, Ruby, and Rust with mise. The version managers let projects that need different versions of a language work side by side. Java comes from Homebrew and asks for your Mac password. A language the app already set up shows as installed. See the articles Python on Mac, Ruby on Mac, Mise on Mac, and Java on Mac.
  • A note about your Mac for AI agents - a short section added to the global instruction files for Claude Code (~/.claude/CLAUDE.md) and Codex (~/.codex/AGENTS.md), saying how your tools were installed. An AI agent that knows this uses your tools instead of installing a second copy. The app keeps what is already in the files and backs them up first. See the article Agent Instructions.
  • Git and GitHub - the app sets the name and email that Git records with each saved version of your work, installs GitHub's command-line tool, and signs you in to GitHub in your web browser. Git is your undo button when an AI agent changes too many files at once.

Mostly free

The "Set Up Your Mac" apps are free. Every app and tool they install is free to install, but two of the AI tools cost money to use fully:

  • Claude Code needs a paid Claude plan. You can use Claude Desktop for chat with a free plan. See the article What's Needed to Run Claude Code.
  • ChatGPT Codex is in the ChatGPT desktop app, which is free to install. You can start coding with it, but you'll soon need a paid ChatGPT plan to finish a sizeable project.

GitHub needs a free account. If you don't have one, the app links to GitHub's sign-up page. You can sign in later. Some connectors also need accounts.

Which steps I recommend

If you want an AI agent to build things for you, take at least four: an AI agent (Claude Code or ChatGPT Codex), the example projects, the note about your Mac for AI agents, and Git and GitHub. The first example project shows you how to set up a folder for an AI agent. Other steps are useful, and free, so you might as well add them.

If you only wanted the tool you came for, click "Finish here". Your Mac is ready for that tool. Run the app again whenever you want the rest.

Doing it yourself

You can do everything the app offers after "Keep going" by hand. Each topic page linked above explains how. The article What the App Will Do describes every step of the app in detail, including the steps before the "Keep going?" screen.

Continue setting up your Mac

Don't miss the full visual roadmap and checklist that shows how to set up a Mac for software development, with all the essential tools and settings you might not yet know about.