macOS 로드맵 — 개발환경으로 길들이는 글 모음

macOS를 개발환경으로 길들이는 일은 여러 갈래로 나뉜다 — 시스템을 어떻게 운영하느냐, 무엇을 얼마나 빨리 호출하느냐, 창을 어떻게 배치하느냐. 이 로드맵은 그 갈래를 주제별 섹션으로 묶은 인덱스다. 지금은 시스템 운영 · 런처·생산성 · 창 관리 세 갈래가 채워져 있고, 새 맥을 막 받았다면 위에서부터 순서대로 읽으면 된다. 이미 익숙한 갈래는 건너뛰고 관심 지점부터 진입해도 좋다.

시스템 운영

도구를 얹기 전에, macOS 자체를 운영하다 마주치는 셋업·트러블슈팅 갈래. 새 맥의 출발점이 여기다.

글	핵심
새 맥 초기 설정 — 셋업 순서	시스템 설정 → Homebrew → dotfiles → Git 계정으로 이어지는 day-1 셋업 순서. 각 단계를 심화 글로 연결하는 런북(진입점)
macOS 시스템 설정 — 세벌식·트랙패드·터미널·앱 권한	세벌식 입력, Caps Lock 전환, 세 손가락 드래그, Mission Control 충돌부터 터미널 테마·앱 접근 권한·vim 스크롤까지 macOS 자체 설정 모음
macOS CLI 개발 도구 모음 — Brewfile로 관리하는 터미널 툴킷	cat·ls·find·grep을 대체하는 모던 CLI(bat·eza·fd·ripgrep·zoxide)부터 fzf·lazygit·delta, 언어 버전 관리까지 실제 Brewfile 기준 갈래별 정리
새 맥에 더 얹을 보조 유틸 모음	Ice(메뉴바)·Stats(모니터)·Shottr(스크린샷)·BetterDisplay(디스플레이)·Ghostty(터미널) — 큰 도구 다음에 취향껏 얹는 보조 유틸을 무엇·왜·대안까지
Docker 실행 시 Operation not permitted 에러 해결	macOS 파일·폴더 접근 권한 누락이 원인. 시스템 설정에서 Docker에 권한을 부여해 해결
brew cleanup 후 java_home이 엉뚱한 버전을 반환할 때	Homebrew가 옛 JDK를 지우며 깨진 /Library/Java/JavaVirtualMachines 심볼릭 링크 복구

런처·생산성 — Raycast

시스템을 잡았다면, 다음은 “무엇을 빠르게 호출하느냐”의 축이다. 명령 팔레트·클립보드 히스토리·스니펫·확장이 여기 속한다. Raycast에도 창 관리 기능이 있어 뒤에 나올 도구들과 역할이 겹칠 수 있다. 그래서 이 갈래의 출발점은 “무엇을 켜느냐”가 아니라 “무엇을 끄고 어디까지만 맡기느냐”다.

글	핵심
Raycast를 검색 계층으로 한정하기 — AeroSpace·Hammerspoon과 안 겹치게 쓰는 법	세 도구를 공간·자동화·검색 세 축으로 분업, Raycast의 창 관리 기능은 끄고 “검색형 진입 계층”으로 한정, Hammerspoon과의 경계선, 설정은 Cloud Sync가 정공법

먼저 런처 자체를 고르는 단계라면 Spotlight·Alfred·Raycast 비교부터 보고 오면 된다. 창 관리·자동화까지 포함한 생산성 앱 전반은 macOS 생산성 앱 정리에서 큰 그림을 잡을 수 있다.

창 관리 — AeroSpace + Hammerspoon

가장 깊이 들어가는 갈래. macOS 창 관리는 결국 두 축이다. 작업 공간(워크스페이스)을 나누는 것과 한 화면 안에서 창을 배치하는 것. 이 블로그는 각각을 잘하는 도구에 맡긴다 — AeroSpace(공간)와 Hammerspoon(배치·자동화). 둘은 open -g hammerspoon:// URL scheme으로 느슨하게 연결된다.

핵심 멘탈 모델은 분업이다.

담당	도구
공간(워크스페이스) 관리	AeroSpace
화면 내 창 위치·크기	Hammerspoon
정보 표시·알림·자동화	Hammerspoon

AeroSpace를 고른 이유는 SIP(System Integrity Protection)를 비활성화하지 않는다는 점이다. 자체 가상 워크스페이스로 macOS 네이티브 Spaces를 우회해 OS 업데이트에 강하다. (yabai는 전체 기능에 SIP 비활성화가 필요해 업데이트마다 깨지기 쉽다.)

기본기 — 두 도구를 각각 먼저 익히기

연동에 들어가기 전에, AeroSpace와 Hammerspoon을 하나씩 손에 익히는 단계. 각 도구의 설치·핵심 개념·기본 단축키를 잡는다.

글	핵심
Rectangle.app 기본 — 가장 쉬운 macOS 창 분할	코드 없이 지금 당장 창 분할. 무료·오픈소스 앱 설치, ⌃⌥ 반·1/3·꼭짓점 분할 단축키, 드래그 스냅. 가장 쉬운 출발점
AeroSpace 기본 — 워크스페이스·단축키·on-window-detected	SIP 비활성화 없이 쓰는 타일링 워크스페이스 매니저. alt-hjkl 포커스·이동, 워크스페이스 전환, .aerospace.toml의 mode.main.binding과 앱 자동 배치
Hammerspoon 기본 — init.lua·hs API·ipc CLI·모듈 구조	Lua로 macOS 자동화. Accessibility 권한, hs.hotkey.bind, hs API 맛보기, hs CLI와 URL scheme, 설정을 모듈로 쪼개기

가장 쉬운 진입은 Rectangle.app(GUI 앱)으로 창 분할 감을 잡는 것이다. 여기서 더 나아가 워크스페이스 분리는 AeroSpace, 정밀 배치·자동화는 Hammerspoon으로 넘어간다. Rectangle의 기능을 Hammerspoon으로 옮기는 과정은 아래 2단계에서 다룬다.

1단계 — 연동의 기본기 (연계 & 재정렬)

두 도구를 어떻게 잇는지, 그 seam을 실전 예제로 익히는 단계. 손으로 잘못 옮긴 창을 단축키 하나로 제자리에 되돌리는 기능을 만든다.

글	핵심
AeroSpace + Hammerspoon — 창을 한 번에 제자리로 재정렬하기	on-window-detected가 한 번만 발동하는 한계, .aerospace.toml 매핑을 파싱해 전체 창 재배치, open -g hammerspoon://로 완료 알림. bash 3.2 함정·ipc 모듈까지

여기서 URL scheme 연동 패턴을 익히면 나머지 두 글의 토대가 된다.

2단계 — 화면 내 배치 (Hammerspoon 단독)

워크스페이스를 나눴다면, 이제 한 화면 안에서 창을 반·1/3·꼭짓점으로 배치하고 싶어진다. Rectangle.app 대신 Hammerspoon으로 직접 구현한다. 이 단계에서 “AeroSpace를 왜 floating으로 두는가”라는 분업의 실체가 드러난다.

글	핵심
Rectangle.app을 Hammerspoon으로 대체하기 — 화면 내 창 분할	move_win 클로저 팩토리로 모든 분할을 한 줄로, win:id()별 이전 프레임 저장으로 전체화면 토글, AeroSpace floating 레이아웃과의 역할 분담

3단계 — 워크스페이스 연동 심화 (정보 오버레이)

연동에 익숙해지면 “지금 몇 번 공간이지, 뭐가 열려 있지”를 화면에 띄우는 HUD를 붙일 수 있다. 여기서 Hammerspoon의 비동기 처리(외부 CLI 연쇄 호출)를 다룬다.

글	핵심
AeroSpace 워크스페이스에 정보 오버레이 붙이기 — Hammerspoon 비동기 알림	exec-on-workspace-change 훅, 중첩 hs.task로 비동기 연쇄(앞 결과가 뒤 입력), stdout 파싱·중복 제거, hs.alert 스타일 커스터마이즈

창 관리 갈래 진입 가이드

• 타일링 WM이 처음이라면 먼저 AeroSpace를 설치하고 기본 단축키(Alt+1~9 전환, Alt+H/J/K/L 포커스)에 익숙해진 뒤 1단계로.
• AeroSpace는 쓰는데 Hammerspoon 연동이 처음이라면 1단계 재정렬 글이 가장 좋은 출발점.
• 한 화면 안 배치가 불편하다면 2단계 Rectangle 대체로 직행.
• 워크스페이스 전환이 헷갈린다면 3단계 오버레이로.

보완 — 창 전환기 (AltTab)

방향 이동·워크스페이스로는 안 잡히는 “흩어진 특정 창으로 점프”는 별도 창 전환기가 메운다. 타일링 셋업과 독립적으로 얹는 보완 도구다.

글	핵심
AltTab — 타일링 WM의 빈틈을 메우는 창 전환기	macOS Cmd+Tab이 못 하는 창 단위·썸네일·크로스 워크스페이스 전환. 권한(손쉬운 사용+화면 기록), Option+Tab으로 충돌 회피

트러블슈팅 — 단축키가 갑자기 안 될 때

글	핵심
AeroSpace 단축키가 갑자기 안 될 때 — macOS Secure Input	Secure Input이 활성이면 시스템 핫키를 못 잡는다. 어느 프로세스가 잡았는지 진단하고 푸는 법

---

데스크톱 쪽 공간 관리를 잡았다면, 터미널 안 공간 관리는 tmux 로드맵과 함께 보면 데스크톱–터미널 양쪽을 한 번에 다룰 수 있다.