README.md

Documentation index

Welcome to the MacDevSetup documentation. Every tool, command, and workflow has a focused page; this index is the map.

Start here: Setup guide · Troubleshooting · How it works (architecture)

For the project overview, install steps, and command reference, see the project README.

Getting started

• Setup guide
• Troubleshooting
• Homebrew
• Package inventory (USED / INSTALLED / TOOLING)
• Workstation audit and update checks
• Architecture overview
• CLI command discovery (internals)

Command-line tools

• Development CLI tools (Git, jq, ripgrep, fnm, uv, shfmt)
• bat
• lsd
• duf
• dust
• tokei
• tree
• autojump

Shell, prompt & terminal

• Zsh
• Antidote (plugin manager)
• Powerlevel10k (prompt)
• Warp terminal

Git

• Git configuration
• Git Delta
• Gitmoji commit convention

Editors

• Visual Studio Code
• Sublime Text

PHP & Symfony

• PHP & Symfony runtime
• Xdebug
• Coverage
• Static analysis
• Coding standards
• Pest
• Mutation testing

Containers & Docker

• OrbStack
• ctop
• Hadolint

Web & API

• Bruno (optional API client)
• Google Chrome
• Firefox
• Excalidraw
• Favicons
• Image services

Databases

• Beekeeper Studio
• libpq

AI tools

• Claude desktop
• Codex CLI
• codexbar
• Ollama

Productivity & macOS

• Raycast
• CleanShot X
• Obsidian
• Notion (optional)
• GIMP
• macOS defaults
• Menu bar (Thaw, SwiftBar & optional Stats)
• terminal-notifier
• Pearcleaner

Security & SSH

• Gitleaks
• KeeWeb
• SSH configuration

Code quality & CI

• markdownlint-cli2
• Lychee (link checker)
• EditorConfig checker
• ShellCheck
• Pre-commit
• Continuous integration, commit selection and tool version maintenance
• Act (local CI)
• actionlint

Monitoring

• Sentry

Keyboard

• Français OSS layout (French typists)

Maintainer & internals

• Release process
• Visual assets roadmap

---

← Project README