Raycast를 검색 계층으로 한정하기 — AeroSpace·Hammerspoon과 안 겹치게 쓰는 법
AeroSpace·Hammerspoon·Raycast는 모두 '단축키로 뭔가를 한다'는 점에서 기능이 겹친다. 세 도구를 공간·자동화·검색 세 축으로 분업하고, Raycast는 '검색형 진입 계층'으로 한정해 충돌을 없애는 멘탈 모델을 정리한다.
macOS 로드맵 — 창 관리 시리즈에 이어 런처·생산성 갈래의 첫 글입니다. 런처 자체를 고르는 문제(Spotlight·Alfred·Raycast 비교)는 macOS 생산성 런처 비교를 먼저 보세요. 이 글은 이미 Raycast를 쓰기로 정한 뒤, 창 관리 도구와 어떻게 안 겹치게 배치하느냐를 다룹니다.
Raycast를 설치하고 나면 흔히 부딪히는 문제가 있다. 이미 창 관리 도구를 쓰고 있는데 Raycast도 창 관리 기능을 갖고 있어서 서로 싸운다는 것이다. 여기에 Hammerspoon 같은 자동화 런타임까지 있으면, 세 도구가 전부 “단축키를 누르면 뭔가 한다”는 점에서 역할이 뭉개진다.
이 글은 AeroSpace(타일링 WM) + Hammerspoon(자동화) + Raycast(런처) 세 도구를 쓸 때, Raycast를 어디까지만 맡겨야 충돌 없이 셋이 공존하는지를 정리한다. 결론부터 말하면 Raycast는 “검색형 진입 계층”으로 한정하는 것이다.
문제: 세 도구의 기능이 겹친다
각 도구는 원래 담당 영역이 다르지만, 기능 표를 펼쳐 보면 교집합이 크다.
| 기능 | AeroSpace | Hammerspoon | Raycast |
|---|---|---|---|
| 창 위치·크기 배치 | ✅ | ✅ | ✅ (내장) |
| 워크스페이스 전환 | ✅ | ||
| 전역 단축키(hotkey) | ✅ | ✅ | ✅ |
| 앱 실행·토글 | ✅ | ✅ | |
| 파일·명령 검색 | ✅ | ||
| 클립보드·스니펫 | (직접 구현) | ✅ (내장) | |
| 확장(외부 서비스 연동) | ✅ |
문제는 “창 위치·크기 배치”와 “전역 단축키” 행이다. 세 도구가 다 할 수 있다. 아무 계획 없이 각각의 기본값을 켜두면, 같은 창을 두 도구가 서로 다른 규칙으로 옮기려 들고, 같은 키 조합을 둘이 가로채려 든다. 가장 흔한 사고가 Raycast의 Window Management 기능을 켠 상태에서 타일링 WM을 함께 쓰는 것이다.
멘탈 모델: 하나의 축에 하나의 도구
겹침을 없애는 원칙은 단순하다. 각 도구를 서로 다른 “축(axis)” 하나에만 배정한다. macOS를 다루는 축은 크게 셋이다.
| 축 | 질문 | 담당 도구 |
|---|---|---|
| 공간(space) | 작업 공간을 어떻게 나누나 | AeroSpace |
| 배치·자동화(action) | 화면 안 창을 어떻게 놓고, 무엇을 자동화하나 | Hammerspoon |
| 검색·진입(search) | 무엇을 타이핑해서 찾아 실행하나 | Raycast |
이 표의 핵심은 “창 배치”를 Hammerspoon 한 곳에만 몰아준다는 점이다. Raycast에도 창 관리 기능이 있지만 쓰지 않는다. 세 도구가 겹치는 유일한 실전 배치는 이렇게 나온다.
왜 배치를 Hammerspoon에 몰아주는가? 창 배치는 “이전 프레임을 기억했다가 토글”, “특정 앱만 예외 처리” 같은 상태와 조건이 붙는 로직이 금방 필요해진다. Raycast의 내장 창 관리는 이런 커스텀이 막혀 있고, 스크립트로 확장하려면 결국 Hammerspoon 같은 런타임이 필요하다. 배치 로직을 한 곳(Hammerspoon)에 두면 규칙이 분산되지 않는다.
AeroSpace·Hammerspoon 두 축을 실제로 엮는 방법은 이 블로그의 창 관리 시리즈에서 다뤘다. 이 글은 세 번째 축인 Raycast = 검색 계층에 집중한다.
시작하기: Spotlight 호출 단축키를 Raycast로 넘기기
Raycast를 주 런처로 사용하려면 기본 Spotlight와 ⌘ + Space 단축키가 충돌하지 않도록 한다.
- 시스템 설정 → 키보드 → 키보드 단축키 → Spotlight에서 Spotlight 검색 호출에 할당된
⌘ + Space를 해제하거나 다른 조합으로 변경한다. - Raycast → Settings → General에서 Raycast Hotkey를
⌘ + Space로 설정한다. ⌘ + Space를 눌러 Raycast가 실행되는지 확인한다. macOS 버전에 따라 메뉴 명칭은 달라질 수 있다.
이 작업은 Spotlight의 호출 단축키를 바꾸는 것이지 Spotlight 검색 인덱스를 삭제하거나 시스템 검색 기능을 완전히 끄는 것이 아니다. Raycast가 파일 검색 등에 시스템 인덱스를 활용할 수 있으므로 Spotlight 자체를 무리하게 비활성화할 필요는 없다.
Safari 웹앱을 Raycast에서 실행하기
Safari에서는 웹사이트를 독립적인 앱 창으로 사용할 수 있다.
- Safari에서 원하는 웹사이트를 연다.
- 메뉴 막대에서 파일 → Dock에 추가를 선택한다(macOS Sonoma 14 이상).
- 이름을 지정하고 추가하면 Dock에서 웹앱을 실행할 수 있다.
사용자별 앱 폴더와 시스템 앱 폴더
| 위치 | 범위 |
|---|---|
/Applications | 일반적으로 시스템의 여러 사용자에게 제공되는 앱 |
~/Applications | 현재 사용자 계정의 앱 |
Safari 웹앱은 ~/Applications에 생성될 수 있다. 이를 무조건 /Applications로 옮길 필요는 없다.
사례: Dock에는 있지만 Raycast 검색에 안 나타남
macOS 재설정 후 Safari로 설치한 ChatGPT 웹앱이 Dock에서는 실행되지만 Raycast의 Applications 검색 결과에 나타나지 않았다.
확인한 경로:
1
2
find ~/Applications /Applications -iname '*ChatGPT*.app' 2>/dev/null
# /Users/clang/Applications/ChatGPT.app
메타데이터 확인:
1
2
3
mdls -name kMDItemContentType -name kMDItemCFBundleIdentifier ~/Applications/ChatGPT.app
# kMDItemCFBundleIdentifier = "com.apple.Safari.WebApp"
# kMDItemContentType = "com.apple.application-bundle"
이 결과는 Safari 웹앱이 실제 .app 번들로 존재한다는 뜻이다. Bundle ID가 com.apple.Safari.WebApp인 사실만으로 Raycast가 모든 Safari 웹앱을 지원하지 않는다고 단정할 수는 없다.
진단 순서:
open ~/Applications/ChatGPT.app으로 해당 웹앱이 직접 실행되는지 확인한다.- Raycast의 Settings → Applications → Search Scopes에서
~/Applications를 검색 범위에 포함할 수 있는지 확인한다. 메뉴와 검색 범위 설정은 Raycast 버전에 따라 다를 수 있다. - 앱 검색에 여전히 나타나지 않으면 Raycast의 앱 검색 범위·인덱싱·필터링 문제를 구분해 확인한다.
- 우회 방법으로 Raycast Script Command에서
open "$HOME/Applications/ChatGPT.app"을 실행하도록 구성할 수 있다. 이 방법은 앱 검색 인덱싱 자체를 고치는 것은 아니다.
사례 상태: 웹앱의 위치와 Bundle ID, Raycast에서 검색되지 않는 현상까지 확인했다. Search Scopes에 디렉터리를 추가하려는 시도는 실패했고, Script Command 등 우회 방법의 최종 성공 여부는 확인되지 않았다. Quicklink에 셸 명령을 직접 입력하면 실행된다고 가정하지 않는다.
1단계: Raycast의 창 관리 기능을 끈다
가장 먼저 할 일은 충돌원 제거다. 타일링 WM이나 Hammerspoon으로 창을 배치하고 있다면, Raycast의 Window Management는 완전히 비활성화한다.
Settings → Extensions → Window Management에서 각 명령의 hotkey를 비우거나 확장 자체를 꺼두면 된다. 이걸 안 하면 “창을 반으로 나누는” 같은 조작이 어느 도구에 매핑됐는지 헷갈리고, 최악의 경우 두 도구가 같은 창을 동시에 옮기려다 프레임이 튄다.
Raycast에 창을 맡기지 않는다 — 이 한 문장이 세 도구 공존의 전제다.
2단계: Raycast가 실제로 값어치 있는 지점만 남긴다
창 관리를 뺀 Raycast는 “무엇을 타이핑해서 찾아 실행하느냐”에 집중한다. 이 축에서 Raycast는 Spotlight를 확실히 넘어선다.
Extension Store — 다른 런처와 갈리는 지점
Raycast의 정체성은 확장 스토어다. GitHub·Linear·Jira·Notion·1Password·Homebrew 같은 외부 서비스를 런처 창 안에서 바로 조회·조작한다.
brew검색으로 패키지 설치- PR·이슈 목록을 런처에서 훑고 바로 열기
- 1Password 항목 검색
Alfred의 워크플로가 스크립트 조립이라면, Raycast는 설치형 확장이라 진입 장벽이 낮다.
클립보드 히스토리 · 스니펫 — 내장
별도 클립보드 앱(Maccy 등)이나 스니펫 앱을 띄우지 않아도 된다. Raycast에 기본 내장이라 런처 하나로 검색 계층이 통합된다. 이게 “진입 계층을 Raycast로 몰아준다”의 실질적 이득이다.
Quicklink · Script Command — 검색형 실행
자주 여는 URL·경로·명령을 별칭으로 등록해두고 타이핑으로 실행한다. Hammerspoon의 물리 단축키와 목적이 겹쳐 보이지만, 진입 방식이 다르다 (아래에서 경계선을 정리한다).
3단계: Hammerspoon과 Raycast의 경계선
배치는 Hammerspoon, 검색은 Raycast로 갈랐지만, “앱을 띄운다” 같은 액션은 둘 다 할 수 있어 마지막 회색지대가 남는다. 경계선은 진입 방식으로 긋는다.
| 상황 | 도구 | 이유 |
|---|---|---|
| 손이 이미 키보드에 있고, 정해진 앱을 반사적으로 토글 | Hammerspoon | 물리 단축키(Cmd+Alt+T → 터미널)가 무의식적 근육기억에 맞다 |
| 이름을 타이핑해서 찾아 실행 (뭘 열지 매번 다름) | Raycast | 검색 UI가 후보를 좁혀준다 |
| 외부 서비스 조회·조작 (PR, 노션 페이지 등) | Raycast | 확장이 데이터를 가져온다 |
| 상태·조건이 붙는 자동화 (창 프레임 기억, 워크스페이스 훅) | Hammerspoon | 스크립트 런타임이 필요 |
한 문장으로: “어느 키를 누를지 몸이 아는 것”은 Hammerspoon, “이름을 쳐서 찾는 것”은 Raycast다. 이 기준으로 나누면 두 도구의 hotkey가 서로를 침범하지 않는다.
설정 관리: Cloud Sync가 정공법이다
마지막으로 실무적인 함정 하나. Raycast 설정을 dotfiles로 버전 관리하려는 시도는 대체로 헛수고다. Raycast는 설정을 앱 내부 저장소에 보관하고, 텍스트 설정 파일을 외부에 노출하지 않는다.
- 심링크로 dotfiles에 끌어오는 건 도구가 의도하지 않은 우회라, 앱 업데이트 때 깨지기 쉽다.
- 정공법은 Raycast 자체의 Cloud Sync로 설정·스니펫·Quicklink를 동기화하는 것이다.
그래서 dotfiles 쪽에는 설치 정의 한 줄만 남기는 게 맞다.
1
2
# Brewfile
cask "raycast"
설정 이식은 Raycast에 맡기고, dotfiles는 “이 머신에 Raycast를 설치한다”는 사실만 추적한다. 도구가 제공하는 동기화 메커니즘을 억지로 파일로 우회하지 않는 것이 관리 비용을 낮춘다.
정리
세 도구가 겹쳐 보이는 건 전부 “단축키로 뭔가 한다”는 표면 때문이다. 축으로 나누면 겹침이 사라진다.
- AeroSpace → 공간(워크스페이스) 분할
- Hammerspoon → 화면 내 배치 + 조건·상태가 붙는 자동화 + 반사적 물리 단축키
- Raycast → 검색형 진입 계층 (앱·파일·확장·클립보드·스니펫). 창 관리 기능은 끈다.
Raycast를 “또 하나의 단축키 도구”로 쓰면 Hammerspoon과 싸우기만 한다. 이름을 타이핑해 뭔가를 찾아 실행하는 검색 계층으로 한정하는 것 — 그게 세 도구가 안 겹치는 유일한 배치다.
관련 글
- 런처 자체 선택·생산성 앱 전반: macOS 생산성 런처 비교와 생산성 앱 큰 그림 (Spotlight·Alfred·Raycast·Rectangle·BTT)
- 창 관리 축 실전: AeroSpace + Hammerspoon 창 재정렬, Rectangle 대체 화면 분할