# Mac Tahoe Development Setup
A complete, opinionated, modern setup for software development on an Apple Silicon Mac running macOS Tahoe (26). Start with the general setup, then add whichever languages you work in.
## Where to start
Everyone starts here:
- [[General_Development_Mac_Tahoe_Setup|General Setup]] — the foundation: Homebrew, Git, GitHub CLI, Ghostty, Starship, VS Code, and Claude Code
Then pick the language(s) you'll be working with:
- [[Python_Development_Mac_Tahoe_Setup|Python]] — uv, ruff, mypy, ipython
- [[C_Development_Mac_Tahoe_Setup|C]] — cmake, ninja, llvm, raylib
- [[Ruby_Development_Mac_Tahoe_Setup|Ruby]] — rv, Bundler
- [[Go_Development_Mac_Tahoe_Setup|Go]] — go, golangci-lint, gopls
- [[Rust_Development_Mac_Tahoe_Setup|Rust]] — rustup, cargo tooling
## What you'll end up with
A fast, modern terminal-first toolchain: **Ghostty** as the terminal with a **Starship** prompt, **Homebrew** managing system packages, per-language version managers instead of system interpreters, **VS Code** wired up with the right extensions per language, **Git + GitHub CLI** with SSH configured, and **Claude Code** available in both Ghostty and VS Code. Each language guide ends with a small calculator/demo project, unit tests, and a GUI example so you can confirm the toolchain end to end.
Every guide is independent once the general setup is done — they're peers, not a sequence, so jump straight to the language you need.
## Companion files
Recommended configuration files to copy into place as you work through the guides:
- [[_resources/configs/ghostty-config|Ghostty config]]
- [[_resources/configs/starship.toml|Starship config]]
- [[_resources/configs/vscode-settings.json|VS Code settings]]
> [!note] How to use these guides
> The guides are written to be **copy/pasted in order** — each is a sequence of commands, not a single runnable script. Some steps (GitHub/Anthropic OAuth, pasting config files, uploading your SSH key) are deliberately manual. If you use an AI assistant other than Claude, the AI-setup steps will differ, and none of the AI setup is required in order to code.