The Mac guide gives you the clean, opinionated path. This page is the honest second pass: why each choice was made, what else you could have done, what we deliberately left out, the trending tools worth a look, how to get ready for Mythos, and how to lock the whole thing down.
Written May 2026. The AI-tooling world moves weekly — this is a snapshot of the landscape and the reasoning, not gospel.
Each guide step made one choice for clarity. Here's the reasoning and the roads not taken.
We chose: the built-in Terminal + Homebrew + Node (via brew install node).
Why: Homebrew is the de-facto Mac package manager — one line installs almost anything, no hunting for download buttons. Node because three of the agents are npm packages.
Alternatives worth knowingxcode-select --install) are often a prerequisite — Homebrew pulls them in automatically on first install, but if a command complains about a missing compiler or git, this is the fix.We chose: npm global installs of each.
Why: one consistent install method across every OS, easy to teach.
Alternatives & notes (May 2026)/goal workflows, and auto mode — worth turning on once you're comfortable. The native binary installer (curl -fsSL https://claude.ai/install.sh | bash) avoids needing Node at all.brew install codex.We chose: the one-line installer from Nous Research.
Why: it's the most model-flexible of the bunch and a good reminder that "the big three" isn't the whole field.
NotesWe chose: the menu-bar cask app (brew install --cask tailscale), signed-in with one account across devices.
We chose: Ollama + llama3.2 as a safe first model.
qwen3-family (Qwen 3.6 is a standout for coding, with MCP-native tool use and huge context), deepseek-r1 for reasoning, gemma3 for small/fast. llama3.2 is a gentle starting point, not the ceiling.The main guide is terminal-first because every agent ships its CLI first and best. But many people work better in a code editor with a file tree, inline diffs, and a chat pane on the side. Here is the honest, fully-detailed editor path on the Mac — install commands, which extensions actually help, what it gives you, what it costs, and when to pick it over (or alongside) the terminal.
Install VS Code on the Macbrew install --cask visual-studio-code — the same cask flow used elsewhere in the Mac guide..zip from code.visualstudio.com and drag Visual Studio Code.app into /Applications.brew install --cask vscodium) — the same editor, MIT-licensed binary, no Microsoft telemetry. Most extensions work; the Microsoft Remote-* family is license-restricted to Microsoft's own VS Code build.code command in your shell: open VS Code → ⇧⌘P → "Shell Command: Install 'code' command in PATH". Then code . in any project folder opens it..env, .git, node_modules, .secrets/, and any private folders to files.exclude in .vscode/settings.json so extensions don't index them. Same hygiene as the CLI permissions in Part 5./goal workflows, auto mode) land in the CLI first and reach the extension weeks later. If you want the bleeding edge, the terminal wins.telemetry.telemetryLevel if that matters.brew install --cask cursor / windsurf); both are full VS Code forks so your extensions mostly carry over.The guide is deliberately a clean six-step spine. That clarity has a cost: real omissions. Here they are, honestly, with the reason each was cut.
| Left out | What it is | Why it was cut |
|---|---|---|
| Hermes Agent | Nous Research's self-improving, model-agnostic coding agent | Genuinely an oversight in v1 — it's newer and niche. Now added as the bonus 4th agent. A good reminder that "the big three" isn't the whole field. |
| OpenCode | The leading open-source CLI agent (150K+ GitHub stars, LSP, multi-session) | Cut to keep the core to vendor-backed tools with simple logins. Arguably the most defensible addition — see Trending below. |
| Git | Version control — how you save and undo real work | Assumed, not taught. Macs get it via xcode-select --install (or it's bundled with the Command Line Tools Homebrew pulls in). The moment you do serious coding you need it. |
| Python + uv | The runtime many AI tools (Hermes, most MCP servers) need | Skipped to keep Node as the only runtime. brew install python uv fills the gap. |
| MCP servers | The standard plugs that connect agents to your files, GitHub, browser, data | The biggest conceptual omission. MCP is where the real power is going (see the tool map). The guide installs the agents; MCP is the next layer. |
| Node version manager | nvm / fnm / Volta | One layer too many for a first setup; needed once you juggle projects. |
| Cursor / Windsurf | VS Code forks built AI-first | Left out — they belong on the tool map as alternative editors. VS Code itself is now covered above as the editor route. |
Scanning the developer conversation on X and GitHub in May 2026, here's what's hot that the guide doesn't yet mention. All run natively on the Mac, Apple Silicon especially.
The open-source CLI agent everyone's talking about — 150K+ stars, ~6.5M monthly devs. LSP integration, multiple parallel sessions, shareable session links. The strongest "free, bring-your-own-model" alternative to Claude Code.
A terminal that's also an agent cockpit — runs Claude Code, Codex, and others in one windowed UI with panes. Nice if the bare terminal feels stark.
Goose (from Block) and OpenHands are open-source autonomous agents that take a goal and run a long multi-step job. The frontier of "set it and walk away."
93K+ stars. A "spec-driven development" workflow that teaches any agent (Claude Code, Copilot, Gemini, etc.) to plan before it codes. Tessl and Kiro play in the same space.
The plug-ins that matter: chrome-devtools-mcp (let an agent drive Chrome), filesystem, GitHub, database connectors. This is the fastest-moving, highest-leverage area right now.
An agentic open model with a 1M-token context and MCP-native tool use — a serious local option for Ollama if your hardware can handle it.
Mythos is Anthropic's first model specialized for one domain: defensive cybersecurity. Announced April 7 2026 as the engine of Project Glasswing, it has already found a 27-year-old vulnerability in OpenBSD and bugs in FFmpeg. It is invitation-only ($25 / $125 per million tokens), shipped to 12 founding orgs and 40+ critical-infrastructure partners — not a download. Full briefing →
So "getting ready" isn't an install — it's preparing your environment so that when domain-specialized models (Mythos and the wave behind it) open up, you can point them at something useful:
You're installing tools that can read your files, run commands, and reach the internet, plus a private network and a local model server. That's a lot of power. Here's how to keep it from biting you — Mac specifics first, then universal rules.
ANTHROPIC_BASE_URL setting and exfiltrate your API key in plaintext. Anthropic patched it before disclosure — the lesson stands: keep Claude Code updated, install only from official sources, and be suspicious of any config that reroutes where a tool "phones home.".env files, SSH keys, .secrets, and certificates — and to not read its own config (which could be used to manipulate it).npm install -g and curl … | bash run other people's code. Only use the exact official sources in the guide; don't paste install one-liners from random blog posts or X replies.brew upgrade, npm update -g); most agent fixes ship fast.OLLAMA_HOST=0.0.0.0:11434 exposes your model server to the network. Only do this behind Tailscale — never on a public IP or open Wi-Fi. There's no password on Ollama by default.