setup-macos

Stars10

Forks1

UpdatedJuly 3, 2026 at 02:10

Full macOS development environment bootstrap — orchestrates Homebrew, ZSH, Vim/Neovim, tmux, Git+gh, Ghostty, Hysteria2, and macOS preferences. Supports interactive multi-select. Use this skill when the user wants to set up a new Mac, configure a new machine, bootstrap a development environment, or run a full macOS setup.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

yanmxa

yanmxa/cc-plugins

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Network and Computer Systems AdministratorsComputer and Mathematical Occupations·SOC 15-1244

File Explorer

2 files

SKILL.md

readonly

name	setup-macos
description	Full macOS development environment bootstrap — orchestrates Homebrew, ZSH, Vim/Neovim, tmux, Git+gh, Ghostty, Hysteria2, and macOS preferences. Supports interactive multi-select. Use this skill when the user wants to set up a new Mac, configure a new machine, bootstrap a development environment, or run a full macOS setup.
allowed-tools	["Bash","Read","Write","Edit","AskUserQuestion"]

Setup macOS

Bootstrap a macOS development environment with a multi-select component picker. Each component is also independently runnable from its own skill.

Components

ID	What it installs
`brew`	Homebrew (required by everything else)
`zsh`	Oh My Zsh + plugins + powerlevel10k + uv + fnm + Go + self-contained `.zshrc` + `~/.env` template
`vim`	Neovim with full Lua config
`tmux`	tmux + TPM + Dracula theme + optimized keybindings
`git`	Git global config + GitHub CLI (`gh` auth) + SSH key + global gitignore
`ghostty`	Ghostty terminal + MesloLGL Nerd Font + optimized config
`hysteria2`	Hysteria 2 proxy client + launchd service + `hy2start`/`hy2stop`/`hy2log` shortcuts
`shadowsocks`	Shadowsocks client (shadowsocks-rust `sslocal`) + `ssstart`/`ssstop`/`sslog`
`sing-box`	sing-box client — one client for both Hysteria2 + Shadowsocks + `sbstart`/`sbnode`
`prefs`	macOS system preferences (4 dev-friendly defaults — see below)

How to invoke this skill

When invoked through Claude (recommended)

Always use AskUserQuestion to let the user multi-select components first. Then call the script with --components <ids>.

Suggested AskUserQuestion call:

question: "Which components do you want to install?"
multiSelect: true
options: one per component above, with the label as id — short description and value as the bare id

Defaults to recommend pre-checked: brew, zsh, git. Other components depend on user preference (proxy is regional, ghostty is a terminal choice, etc.).

After the user picks, run:

bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --components <comma-separated-ids>

Direct CLI invocation (no Claude)

# Interactive Y/n picker for each component
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh

# Explicit selection
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --components zsh,git,hysteria2

# Run everything
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --all

# Show available components
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --list

Language runtimes installed by `zsh` component

Language	Tool	Isolation
Python	uv	`UV_PYTHON_PREFERENCE=only-managed`; `pip install` blocked globally
Node.js	fnm	auto-switches version via `.node-version` / `.nvmrc`
Go	Homebrew	`go.mod` per-project isolation; binaries → `$GOPATH/bin`

Three-tier shell config layout (set up by `zsh` component)

File	Purpose	Tracked?
`~/.zshrc`	Generic config — plugins, PATH, runtimes, aliases	✅ tracked
`~/.env`	Environment variables / API keys (auto-exported)	❌ chmod 600
`~/.zshrc.local`	Machine-specific aliases / functions	❌

What `prefs` actually changes (only 4 settings)

Intentionally minimal — only universally useful for developers, no personal-preference items:

Setting	Why it's universal
`Finder.AppleShowAllExtensions = true`	See full filenames; avoid ambiguous names
`Dock.show-recents = false`	The "recent apps" section is rarely useful, just clutter
`screencapture.location = ~/Desktop/screenshots/`	Stop screenshots from cluttering the Desktop
`DSDontWriteNetworkStores = true`	Don't pollute shared SMB / network drives with `.DS_Store`

Things like Dock auto-hide, tap-to-click, fast key repeat, hidden files in Finder are personal preferences and are not changed.

Re-run individual components

Each component is also a standalone skill:

bash ~/.claude/plugins/setup/skills/setup-zsh/scripts/setup-zsh.sh
bash ~/.claude/plugins/setup/skills/setup-vim/scripts/setup-vim.sh
bash ~/.claude/plugins/setup/skills/setup-tmux/scripts/setup-tmux.sh
bash ~/.claude/plugins/setup/skills/setup-git/scripts/setup-git.sh
bash ~/.claude/plugins/setup/skills/setup-ghostty/scripts/setup-ghostty.sh
bash ~/.claude/plugins/setup/skills/setup-hysteria2/scripts/setup-hysteria2.sh
bash ~/.claude/plugins/setup/skills/setup-shadowsocks/scripts/setup-shadowsocks.sh
bash ~/.claude/plugins/setup/skills/setup-sing-box/scripts/setup-sing-box.sh

The proxy skills (hysteria2, shadowsocks) also have a --server mode that SSH-deploys the server side to a Linux VPS — not part of this macOS picker. See each skill's skill.md.

After setup

Restart terminal (or source ~/.zshrc)
Run p10k configure for the prompt
In tmux: prefix + I to install TPM plugins
Edit ~/.env to add API keys / secrets
If hysteria2 was installed: edit ~/.config/hysteria/config.yaml, then hy2start

More from this repository

same repository

setup-hysteria2

yanmxa/cc-plugins

Install and configure Hysteria 2 — either a CLIENT on macOS (Homebrew binary, config, shortcut commands like hy2start/hy2stop/hy2log/proxyon, optional launchd service) or a SERVER on a Linux VPS over SSH (official installer, self-signed cert, systemd service, firewall, prints client credentials). Ask the user server-vs-client first. Use this skill when the user mentions hysteria2, hy2, proxy client/server setup, deploying a Hysteria2 server, or connecting to a Hysteria2 proxy on a new Mac.

2026-07-0310

setup-shadowsocks

yanmxa/cc-plugins

Install and configure Shadowsocks — either a CLIENT on macOS (shadowsocks-rust sslocal, config, shortcut commands like ssstart/ssstop/sslog/sson, optional launchd service) or a SERVER on a Linux VPS over SSH (shadowsocks-rust ssserver, systemd service, firewall, prints ss:// link + credentials). Ask the user server-vs-client first. Use this skill when the user mentions shadowsocks, ss, sslocal, ssserver, deploying a shadowsocks server, or connecting to a shadowsocks proxy on a new Mac.

2026-07-0310

setup-sing-box

yanmxa/cc-plugins

Install and configure a sing-box proxy client on macOS — one client that speaks BOTH Hysteria2 and Shadowsocks and switches between them. Installs binary via Homebrew, deploys a merged config, adds shortcut commands (sbstart, sbstop, sblog, sbstatus, sbrestart, sbedit, sbnode, sbon, sboff), and OPTIONALLY sets up a launchd auto-start service (asks the user first). Use this skill when the user mentions sing-box, singbox, a unified proxy client, switching between hysteria2 and shadowsocks, or wants one client for multiple protocols on a new Mac.

2026-07-0310

setup-zsh

yanmxa/cc-plugins

Install and configure Zsh with Oh My Zsh, plugins, powerlevel10k theme, and modern CLI tools. Writes a self-contained ~/.zshrc with no external file dependencies. Use this skill when the user mentions setting up zsh, configuring zsh, installing oh-my-zsh, zsh setup, zsh plugins, shell setup, or wants to set up their shell environment on a new machine.

2026-05-0510

git

yanmxa/cc-plugins

Git workflow automation - commit/push with sign-off, create/list/compact/rebase PRs, and contribute to upstream repos. Use this skill whenever the user mentions PR, pull request, create PR, show my PRs, list PRs, squash commits, compact commits, rebase PR, commit and push, push updates, push changes, contribute to a repo, fork and submit, or wants to manage any aspect of Git operations.

2026-05-0510

setup-tmux

yanmxa/cc-plugins

Install and configure tmux on macOS with an optimized config, Dracula theme, TPM plugin manager, and vim-style keybindings. Use this skill when the user mentions setting up tmux, configuring tmux, installing tmux on Mac, tmux setup, tmux configuration, or wants to replicate their tmux environment on a new machine.

2026-05-0510

name	setup-macos
description	Full macOS development environment bootstrap — orchestrates Homebrew, ZSH, Vim/Neovim, tmux, Git+gh, Ghostty, Hysteria2, and macOS preferences. Supports interactive multi-select. Use this skill when the user wants to set up a new Mac, configure a new machine, bootstrap a development environment, or run a full macOS setup.
allowed-tools	["Bash","Read","Write","Edit","AskUserQuestion"]

Setup macOS

Bootstrap a macOS development environment with a multi-select component picker. Each component is also independently runnable from its own skill.

Components

ID	What it installs
`brew`	Homebrew (required by everything else)
`zsh`	Oh My Zsh + plugins + powerlevel10k + uv + fnm + Go + self-contained `.zshrc` + `~/.env` template
`vim`	Neovim with full Lua config
`tmux`	tmux + TPM + Dracula theme + optimized keybindings
`git`	Git global config + GitHub CLI (`gh` auth) + SSH key + global gitignore
`ghostty`	Ghostty terminal + MesloLGL Nerd Font + optimized config
`hysteria2`	Hysteria 2 proxy client + launchd service + `hy2start`/`hy2stop`/`hy2log` shortcuts
`shadowsocks`	Shadowsocks client (shadowsocks-rust `sslocal`) + `ssstart`/`ssstop`/`sslog`
`sing-box`	sing-box client — one client for both Hysteria2 + Shadowsocks + `sbstart`/`sbnode`
`prefs`	macOS system preferences (4 dev-friendly defaults — see below)

How to invoke this skill

When invoked through Claude (recommended)

Always use AskUserQuestion to let the user multi-select components first. Then call the script with --components <ids>.

Suggested AskUserQuestion call:

question: "Which components do you want to install?"
multiSelect: true
options: one per component above, with the label as id — short description and value as the bare id

Defaults to recommend pre-checked: brew, zsh, git. Other components depend on user preference (proxy is regional, ghostty is a terminal choice, etc.).

After the user picks, run:

bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --components <comma-separated-ids>

Direct CLI invocation (no Claude)

# Interactive Y/n picker for each component
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh

# Explicit selection
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --components zsh,git,hysteria2

# Run everything
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --all

# Show available components
bash ${CLAUDE_SKILL_DIR}/scripts/setup-macos.sh --list

Language runtimes installed by `zsh` component

Language	Tool	Isolation
Python	uv	`UV_PYTHON_PREFERENCE=only-managed`; `pip install` blocked globally
Node.js	fnm	auto-switches version via `.node-version` / `.nvmrc`
Go	Homebrew	`go.mod` per-project isolation; binaries → `$GOPATH/bin`

Three-tier shell config layout (set up by `zsh` component)

File	Purpose	Tracked?
`~/.zshrc`	Generic config — plugins, PATH, runtimes, aliases	✅ tracked
`~/.env`	Environment variables / API keys (auto-exported)	❌ chmod 600
`~/.zshrc.local`	Machine-specific aliases / functions	❌

What `prefs` actually changes (only 4 settings)

Intentionally minimal — only universally useful for developers, no personal-preference items:

Setting	Why it's universal
`Finder.AppleShowAllExtensions = true`	See full filenames; avoid ambiguous names
`Dock.show-recents = false`	The "recent apps" section is rarely useful, just clutter
`screencapture.location = ~/Desktop/screenshots/`	Stop screenshots from cluttering the Desktop
`DSDontWriteNetworkStores = true`	Don't pollute shared SMB / network drives with `.DS_Store`

Things like Dock auto-hide, tap-to-click, fast key repeat, hidden files in Finder are personal preferences and are not changed.

Re-run individual components

Each component is also a standalone skill:

bash ~/.claude/plugins/setup/skills/setup-zsh/scripts/setup-zsh.sh
bash ~/.claude/plugins/setup/skills/setup-vim/scripts/setup-vim.sh
bash ~/.claude/plugins/setup/skills/setup-tmux/scripts/setup-tmux.sh
bash ~/.claude/plugins/setup/skills/setup-git/scripts/setup-git.sh
bash ~/.claude/plugins/setup/skills/setup-ghostty/scripts/setup-ghostty.sh
bash ~/.claude/plugins/setup/skills/setup-hysteria2/scripts/setup-hysteria2.sh
bash ~/.claude/plugins/setup/skills/setup-shadowsocks/scripts/setup-shadowsocks.sh
bash ~/.claude/plugins/setup/skills/setup-sing-box/scripts/setup-sing-box.sh

The proxy skills (hysteria2, shadowsocks) also have a --server mode that SSH-deploys the server side to a Linux VPS — not part of this macOS picker. See each skill's skill.md.

After setup

Restart terminal (or source ~/.zshrc)
Run p10k configure for the prompt
In tmux: prefix + I to install TPM plugins
Edit ~/.env to add API keys / secrets
If hysteria2 was installed: edit ~/.config/hysteria/config.yaml, then hy2start

setup-macos

Setup macOS

Components

How to invoke this skill

When invoked through Claude (recommended)

Direct CLI invocation (no Claude)

Language runtimes installed by zsh component

Three-tier shell config layout (set up by zsh component)

What prefs actually changes (only 4 settings)

Re-run individual components

After setup

More from this repository

More from this repository

Setup macOS

Components

How to invoke this skill

When invoked through Claude (recommended)

Direct CLI invocation (no Claude)

Language runtimes installed by zsh component

Three-tier shell config layout (set up by zsh component)

What prefs actually changes (only 4 settings)

Re-run individual components

After setup

Language runtimes installed by `zsh` component

Three-tier shell config layout (set up by `zsh` component)

What `prefs` actually changes (only 4 settings)

Language runtimes installed by `zsh` component

Three-tier shell config layout (set up by `zsh` component)

What `prefs` actually changes (only 4 settings)