AI 에이전트를 활용한 맥북 (macOS) 개발 환경 초기 설정 (macos-agent-bootstrap)

/Technology

DonK 2026. 10. 12. 12:14

새 맥북을 세팅할 때마다 이전에 쓰던 패키지들을 한꺼번에 설치하다 보면 당장 쓰지 않는 툴까지 깔려 환경이 무거워지곤 합니다. 또한 설정 파일에 개인 계정 정보가 섞여 있으면 다른 기기나 외부에서 재사용하기도 번거롭습니다.

요즘은 Antigravity, Claude Code, Cursor 같은 AI 에이전트를 주로 활용하다 보니, 복잡한 쉘 스크립트 대신 에이전트에게 레포지토리를 주고 대화형으로 필요한 것만 설치하도록 구성한 템플릿을 정리해 공유합니다.

처음 환경을 세팅할 때는 맥의 쾌적함을 유지하기 위해 Brewfile에 정의된 최소한의 필수 도구만 설치합니다.

Homebrew: macOS 패키지 매니저
Ghostty: GPU 가속을 지원하는 가벼운 터미널 에뮬레이터 (Nerd Font 심볼이 기본 내장되어 별도 폰트 설정이 필요 없습니다)
Starship: 업데이트가 중단된 Powerlevel10k를 대체하는 Rust 기반의 가벼운 쉘 프롬프트
Neovim: 기본 터미널 에디터 (vim, vimdiff alias 및 기본적인 init.vim 설정 포함)
Zsh 플러그인: zsh-autosuggestions, zsh-syntax-highlighting

기본 코어 외의 개발 도구들은 catalog/optional-packages.md에 정리해 두었습니다. 에이전트가 세팅 과정에서 사용자에게 필요한 항목을 물어보고 선택한 툴만 설치합니다.

Python: 기존에 쓰던 pyenv 대신, 속도가 빠른 uv와 Ruff만 설치해 파이썬 버전 관리(uv python install --default)와 가상환경을 모두 처리합니다.
Git / CLI 유틸리티: GitHub CLI (gh), ripgrep, fd, jq, wget, pre-commit, git-filter-repo
언어 / 빌드 환경: Node.js, pnpm, Yarn, Go, SwiftFormat, xcbeautify, xcode-build-server
클라우드 / DB / 컨테이너: Google Cloud CLI, Azure CLI, PostgreSQL, pgloader, OrbStack, Docker
미디어 / 문서 도구: FFmpeg, ImageMagick, Pandoc, MacTeX

에이전트 터미널 호환 설정 (dotfiles/zshrc)
Cursor나 VS Code, Antigravity 내장 터미널에서 에이전트가 명령어를 실행할 때 프롬프트 테마 때문에 명령 종료를 인식하지 못하고 멈추는 경우가 종종 있습니다. 이를 방지하기 위해 .zshrc 상단에서 IDE/에이전트 터미널을 감지하면 복잡한 테마를 끄고 심플한 프롬프트로 동작하도록 구성했습니다.
멀티 GitHub 계정 및 SSH 설정 템플릿 (dotfiles/git, dotfiles/ssh)
여러 GitHub 계정을 사용할 때 remote URL에 따라 SSH 키와 Git author 정보를 자동으로 분기(includeIf, insteadOf)하는 템플릿을 포함했습니다. 방화벽 환경에서도 문제없이 동작하도록 Port 443(ssh.github.com)을 기본으로 사용합니다.
다양한 AI 에이전트 지원
AGENTS.md 외에도 CLAUDE.md, .cursorrules, .github/copilot-instructions.md, llms.txt, 그리고 현재 맥 상태를 빠르게 확인하는 scripts/audit.sh를 추가해 어떤 에이전트에서든 바로 인식할 수 있게 했습니다.

세팅할 맥에서 레포지토리를 클론한 뒤, 사용하는 AI 에이전트를 실행해 요청하면 됩니다.

# 레포지토리 클론
git clone https://github.com/dongchankim-io/macos-agent-bootstrap.git
cd macos-agent-bootstrap

이후 에이전트 채팅창에 아래와 같이 입력합니다.

AGENTS.md를 읽고 이 맥의 개발 환경 세팅을 진행해 줘.

에이전트가 먼저 scripts/audit.sh 를 실행해 현재 맥에 설치된 항목들을 확인하고, 기존 설정 파일 백업부터 GitHub 계정 설정, 추가 패키지 설치까지 대화형으로 진행해 줍니다.