{"id":50771393,"url":"https://github.com/larrykoo711/new-macos-starter","last_synced_at":"2026-06-11T19:01:27.882Z","repository":{"id":356205559,"uuid":"1129414746","full_name":"larrykoo711/new-macos-starter","owner":"larrykoo711","description":"From Zero to Hero — An opinionated macOS development environment setup guide for engineers. Homebrew, Zsh, Node.js, Python, Go, Docker, Kubernetes, and more.","archived":false,"fork":false,"pushed_at":"2026-05-07T02:59:43.000Z","size":159,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T04:39:58.657Z","etag":null,"topics":["apple-silicon","developer-tools","development-environment","dotfiles","homebrew","macos","setup-script","zsh"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/larrykoo711.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-07T04:08:40.000Z","updated_at":"2026-05-07T02:59:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/larrykoo711/new-macos-starter","commit_stats":null,"previous_names":["larrykoo711/new-macos-starter"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/larrykoo711/new-macos-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larrykoo711%2Fnew-macos-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larrykoo711%2Fnew-macos-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larrykoo711%2Fnew-macos-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larrykoo711%2Fnew-macos-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/larrykoo711","download_url":"https://codeload.github.com/larrykoo711/new-macos-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/larrykoo711%2Fnew-macos-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34213179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-silicon","developer-tools","development-environment","dotfiles","homebrew","macos","setup-script","zsh"],"created_at":"2026-06-11T19:01:26.941Z","updated_at":"2026-06-11T19:01:27.859Z","avatar_url":"https://github.com/larrykoo711.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macOS Starter\n\n\u003e **From Zero to Hero** — An opinionated macOS development environment setup guide for engineers.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Platform](https://img.shields.io/badge/Platform-macOS-blue.svg)](https://www.apple.com/macos)\n[![Architecture](https://img.shields.io/badge/Architecture-Apple%20Silicon%20%7C%20Intel-green.svg)](https://www.apple.com/mac)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n**[中文文档](README.zh-CN.md)**\n\n## Philosophy\n\n```\nShip Fast. Break Things. Fix Faster.\n```\n\n- **Minimal Friction** — One-click setup, zero resistance to start coding\n- **Battle-Tested** — Production-proven toolchain used by top engineers\n- **Opinionated** — Curated choices so you don't waste time deciding\n- **Reproducible** — Consistent environment across all your machines\n\n## Quick Start\n\n### Option 1: AI-Powered Interactive Setup (Recommended)\n\nUse [Claude Code](https://claude.ai/claude-code) for a personalized, conversational setup experience:\n\n```bash\n# Clone this repo\ngit clone https://github.com/larrykoo711/new-macos-starter.git\ncd new-macos-starter\n\n# Start the interactive setup wizard in Claude Code:\n/new-macos-setup\n```\n\nThe AI wizard will:\n1. **Detect** what's already installed on your system\n2. **Ask** your preferences (role, languages, apps)\n3. **Generate** a customized installation plan\n4. **Execute** step-by-step with progress tracking\n\n```bash\n# Quick setup with sensible defaults\n/new-macos-setup --quick\n\n# Use a preset (fullstack, frontend, backend, data, devops)\n/new-macos-setup --preset fullstack\n\n# Preview plan without installing\n/new-macos-setup --dry-run\n```\n\n### Option 2: Traditional Bootstrap Script\n\n```bash\n# Clone this repo\ngit clone https://github.com/larrykoo711/new-macos-starter.git\ncd new-macos-starter\n\n# Run the bootstrap script (installs prerequisites only)\n./scripts/bootstrap.sh\n```\n\nThe bootstrap script will install Xcode CLI Tools, Rosetta 2 (if Apple Silicon), and Homebrew. Then it guides you to use the AI-powered `/new-macos-setup` command for complete configuration.\n\n## What's Inside\n\n### Core Stack\n\n| Category | Tool | Why |\n|----------|------|-----|\n| **Package Manager** | [Homebrew](https://brew.sh) | The standard package manager for macOS |\n| **Shell** | Zsh + Oh-My-Zsh + Starship | Modern shell experience with beautiful prompts |\n| **Terminal** | [Ghostty](https://ghostty.org) + [tmux](https://github.com/tmux/tmux) | Open-source GPU-accelerated terminal with multiplexer (Warp as alt) |\n| **Launcher** | [Raycast](https://raycast.com) | Spotlight replacement + window management |\n| **Version Control** | Git + gh CLI | Native GitHub integration |\n\n### Development Environment\n\n| Category | Tool | Why |\n|----------|------|-----|\n| **Node.js** | fnm + pnpm | Fast version management + efficient package manager |\n| **Python** | uv | Rust-built, manages both versions and dependencies |\n| **Go** | goenv | Multi-version management |\n| **Container** | OrbStack | Lightweight Docker/K8s (replaces Docker Desktop) |\n| **Kubernetes** | kubectl + helm + k9s + kubeswitch | Complete cloud-native toolkit |\n\n### Editor \u0026 IDE\n\n| Tool | Description |\n|------|-------------|\n| [VS Code](https://code.visualstudio.com) | Primary editor (free, mature, great extension ecosystem) |\n| [Claude Code](https://claude.ai/claude-code) extension for VS Code | Native AI pair-programming inside the editor |\n\n### Vibe Coding (AI-Assisted Programming)\n\n| Tool | Description |\n|------|-------------|\n| [Claude Code](https://claude.ai/claude-code) | Anthropic's official agentic CLI (recommended) |\n| [OpenCode](https://github.com/opencode-ai/opencode) | Open-source terminal AI coding tool |\n| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | Multi-model AI desktop client |\n\n### Essential Apps\n\n| Category | Apps |\n|----------|------|\n| **Must Have** | Raycast, 1Password, Chrome, KeepingYouAwake, Keka |\n| **Development** | VS Code, Ghostty, Warp, OrbStack, Proxyman, Sourcetree |\n| **Communication (CN)** | Lark, WeChat, Tencent Meeting |\n| **AI Tools** | Claude Code, Cherry Studio |\n| **System** | iStat Menus, MonitorControl, Gas Mask |\n\n## Documentation\n\n| Chapter | Description |\n|---------|-------------|\n| [00. Troubleshooting](docs/00-troubleshooting.md) | Common issues and solutions |\n| [01. System Setup](docs/01-system-setup.md) | Initial system configuration |\n| [02. Homebrew](docs/02-homebrew.md) | Package manager installation |\n| [03. Shell](docs/03-shell.md) | Zsh + Oh-My-Zsh configuration |\n| [04. Fonts](docs/04-fonts.md) | Programming fonts installation |\n| [05. Dev Environment](docs/05-dev-environment.md) | Git, Node.js, Python, Go, Container |\n| [06. Editor](docs/06-editor.md) | VS Code + Claude Code configuration |\n| [07. Vibe Coding](docs/07-vibe-coding.md) | AI-assisted programming tools |\n| [08. Apps](docs/08-apps.md) | Recommended applications |\n| [09. macOS](docs/09-macos.md) | System optimization |\n| [10. Network (China)](docs/10-network-china.md) | China network mirrors \u0026 proxy |\n\n## Project Structure\n\n```\nmacOS-Starter/\n├── .claude/\n│   ├── commands/\n│   │   └── new-macos-setup.md    # /new-macos-setup command entry point\n│   └── skills/\n│       └── macos-setup/          # AI setup wizard skill\n│           ├── SKILL.md          # Skill definition + Q\u0026A flow\n│           ├── presets.md        # Role-based presets (5 profiles)\n│           └── packages.md       # Complete package registry\n├── scripts/\n│   ├── bootstrap.sh              # Prerequisites installer (Homebrew)\n│   ├── verify.sh                 # Installation verification script\n│   └── Brewfile                  # Homebrew package definitions\n├── configs/\n│   ├── shell/                    # .zshrc (optimized), .zprofile\n│   ├── git/                      # .gitconfig, .gitignore_global\n│   ├── editors/                  # VS Code settings, Biome config\n│   └── terminal/                 # Starship prompt config\n└── docs/                         # Detailed reference guides (01-09)\n```\n\n## Customization\n\n### Post-Installation Setup\n\nAfter running `bootstrap.sh`, complete these manual configurations:\n\n```bash\n# 1. Setup Node.js\nfnm install --lts\nfnm default lts-latest\n\n# 2. Setup Python\nuv python install 3.13\n\n# 3. Configure Git (edit with your info)\ngit config --global user.name \"Your Name\"\ngit config --global user.email \"your.email@example.com\"\n```\n\nSee the [documentation](docs/) for detailed guides.\n\n### Verify Installation\n\nAfter setup, verify all tools are properly installed:\n\n```bash\n./scripts/verify.sh\n```\n\n## Tested Environment\n\n| Component | Version |\n|-----------|---------|\n| macOS | Sequoia 15.x / Sonoma 14.x |\n| Architecture | Apple Silicon (M1/M2/M3/M4) / Intel |\n| Homebrew | 4.x |\n| Node.js | 22.x LTS |\n| Python | 3.12+ |\n| Go | 1.23+ |\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before submitting a PR.\n\n- Found a bug? [Open an issue](https://github.com/larrykoo711/new-macos-starter/issues/new?template=bug_report.md)\n- Have a feature idea? [Start a discussion](https://github.com/larrykoo711/new-macos-starter/issues/new?template=feature_request.md)\n- Want to contribute? [Submit a PR](https://github.com/larrykoo711/new-macos-starter/pulls)\n\n## License\n\n[MIT License](LICENSE) — Use it, modify it, ship it.\n\n## Acknowledgments\n\nInspired by the engineering cultures at YC startups, Silicon Valley companies, and the open-source community.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eBuilt with focus by engineers, for engineers.\u003c/strong\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarrykoo711%2Fnew-macos-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flarrykoo711%2Fnew-macos-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flarrykoo711%2Fnew-macos-starter/lists"}