포스트

Raycast를 검색 계층으로 한정하기 — AeroSpace·Hammerspoon과 안 겹치게 쓰는 법

AeroSpace·Hammerspoon·Raycast는 모두 '단축키로 뭔가를 한다'는 점에서 기능이 겹친다. 세 도구를 공간·자동화·검색 세 축으로 분업하고, Raycast는 '검색형 진입 계층'으로 한정해 충돌을 없애는 멘탈 모델을 정리한다.

Raycast를 검색 계층으로 한정하기 — AeroSpace·Hammerspoon과 안 겹치게 쓰는 법

macOS 로드맵 — 창 관리 시리즈에 이어 런처·생산성 갈래의 첫 글입니다. 런처 자체를 고르는 문제(Spotlight·Alfred·Raycast 비교)는 macOS 생산성 런처 비교를 먼저 보세요. 이 글은 이미 Raycast를 쓰기로 정한 뒤, 창 관리 도구와 어떻게 안 겹치게 배치하느냐를 다룹니다.

Raycast를 설치하고 나면 흔히 부딪히는 문제가 있다. 이미 창 관리 도구를 쓰고 있는데 Raycast도 창 관리 기능을 갖고 있어서 서로 싸운다는 것이다. 여기에 Hammerspoon 같은 자동화 런타임까지 있으면, 세 도구가 전부 “단축키를 누르면 뭔가 한다”는 점에서 역할이 뭉개진다.

이 글은 AeroSpace(타일링 WM) + Hammerspoon(자동화) + Raycast(런처) 세 도구를 쓸 때, Raycast를 어디까지만 맡겨야 충돌 없이 셋이 공존하는지를 정리한다. 결론부터 말하면 Raycast는 “검색형 진입 계층”으로 한정하는 것이다.

문제: 세 도구의 기능이 겹친다

각 도구는 원래 담당 영역이 다르지만, 기능 표를 펼쳐 보면 교집합이 크다.

기능AeroSpaceHammerspoonRaycast
창 위치·크기 배치✅✅✅ (내장)
워크스페이스 전환✅  
전역 단축키(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 단축키가 충돌하지 않도록 한다.

  1. 시스템 설정 → 키보드 → 키보드 단축키 → Spotlight에서 Spotlight 검색 호출에 할당된 ⌘ + Space를 해제하거나 다른 조합으로 변경한다.
  2. Raycast → Settings → General에서 Raycast Hotkey를 ⌘ + Space로 설정한다.
  3. ⌘ + Space를 눌러 Raycast가 실행되는지 확인한다. macOS 버전에 따라 메뉴 명칭은 달라질 수 있다.

이 작업은 Spotlight의 호출 단축키를 바꾸는 것이지 Spotlight 검색 인덱스를 삭제하거나 시스템 검색 기능을 완전히 끄는 것이 아니다. Raycast가 파일 검색 등에 시스템 인덱스를 활용할 수 있으므로 Spotlight 자체를 무리하게 비활성화할 필요는 없다.

Safari 웹앱을 Raycast에서 실행하기

Safari에서는 웹사이트를 독립적인 앱 창으로 사용할 수 있다.

  1. Safari에서 원하는 웹사이트를 연다.
  2. 메뉴 막대에서 파일 → Dock에 추가를 선택한다(macOS Sonoma 14 이상).
  3. 이름을 지정하고 추가하면 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 웹앱을 지원하지 않는다고 단정할 수는 없다.

진단 순서:

  1. open ~/Applications/ChatGPT.app으로 해당 웹앱이 직접 실행되는지 확인한다.
  2. Raycast의 Settings → Applications → Search Scopes에서 ~/Applications를 검색 범위에 포함할 수 있는지 확인한다. 메뉴와 검색 범위 설정은 Raycast 버전에 따라 다를 수 있다.
  3. 앱 검색에 여전히 나타나지 않으면 Raycast의 앱 검색 범위·인덱싱·필터링 문제를 구분해 확인한다.
  4. 우회 방법으로 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로 몰아준다”의 실질적 이득이다.

자주 여는 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과 싸우기만 한다. 이름을 타이핑해 뭔가를 찾아 실행하는 검색 계층으로 한정하는 것 — 그게 세 도구가 안 겹치는 유일한 배치다.


관련 글

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.