첫 실행부터,
내 작업 방식까지.

저장소가 명시한 요구 사항은 macOS 14 이상, Homebrew, Xcode Command Line Tools입니다. Apple Silicon과 Intel Mac을 대상으로 하며, 외부 패키지의 버전은 고정되어 있지 않습니다.

• Homebrew가 없다면 공식 설치 안내 ↗를 먼저 따르세요.
• 터미널에서 아래 명령으로 Command Line Tools를 준비합니다. 설치 안내가 나오면 설치를 마친 뒤 다음 단계로 넘어갑니다.
• 기존 SketchyBar·AeroSpace 설정과 다른 창 관리 도구의 사용 여부를 확인하세요.

xcode-select --install
brew --version
xcode-select -p

아래 명령을 순서대로 실행하세요. 설치 스크립트는 필요한 패키지를 설치하고, 기존 설정을 날짜별 백업으로 옮긴 뒤 새 설정을 복사합니다.

git clone https://github.com/yeo1220/omarchy-mac.git ~/omarchy-mac
cd ~/omarchy-mac
./install.sh

==> Homebrew 패키지 설치
==> 기존 설정 백업
==> 설정 설치 (복사)
==> 메뉴바 전환 헬퍼 빌드
==> macOS 메뉴바 자동 숨김 켜기
==> 실행

설치 완료!
다음 단계

자동으로 설치하는 구성
SketchyBar, JankyBorders, jq, Caskaydia Mono Nerd Font와 기본 옵션의 AeroSpace·CodexBar입니다. Ghostty와 Google Chrome은 설치하지 않습니다. 기존 설정의 두 AeroSpace 위치도 함께 백업합니다.

시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 AeroSpace를 허용하세요. 권한이 있어야 창 관리가 동작합니다.

AI 사용량을 보려면

CodexBar에서 Settings → Providers를 열고 사용할 Claude·Codex·Cursor 공급자를 켭니다. 각 공급자가 요구하는 CLI 로그인·브라우저 세션 등 인증 수단을 준비하세요.

Settings → Providers

Claude · Codex · Cursor
사용할 공급자를 켜고 로그인 수단 준비

CodexBar의 인증·조회 방식은 공급자별로 다릅니다. CodexBar 공식 첫 실행 안내 ↗

바 왼쪽의 번호를 클릭하거나 ⌥ 1–9를 눌러 워크스페이스를 선택합니다. 번호 옆에는 현재 앱 이름이 표시됩니다.

먼저 익힐 세 가지

• ⌥ 2로 2번 공간에 이동합니다.
• ⌥⇧ 1로 현재 창을 1번 공간에 보냅니다.
• ⌥ Tab으로 직전 공간에 돌아갑니다.

포커스 이동은 Option, 창 이동은 Option + Shift를 기준으로 기억하세요. 현재 창은 파란 테두리로 구분됩니다.

기존 앱의 단축키와 충돌할 수 있습니다. ⌘ Enter는 Ghostty의 새 인스턴스를 실행하므로 마지막 창을 닫아도 앱 인스턴스가 남을 수 있습니다.

상단의 Claude, Codex, Cursor를 클릭하면 해당 팝업이 전환되면서 조회를 시작합니다. 다른 공급자의 팝업은 닫히며, 마우스가 벗어나면 팝업이 닫힙니다.

Cursor 12%·3P 92% 10d5h

전체        12% 10d5h 후 초기화
Cursor 모델  35% 10d5h 후 초기화
서드파티    92% 10d5h 후 초기화

• 26m / 5h9m / 4d19h: 초기화까지 26분 / 5시간 9분 / 4일 19시간.
• 3P: Cursor의 서드파티 한도. ↺N: 남아 있는 재설정 크레딧 횟수.
• 기본 갱신은 300초입니다. 클릭은 조회를 시작하며 완료 시간은 외부 도구·서비스에 달려 있습니다.
• 플랜 행 1개 아래에 세부 행 최대 6개가 표시됩니다. 추가 한도 이름과 플랜은 계정·조회 결과에 따라 달라집니다.
• 바의 색은 기본 한도 3개 중 최대 사용률을 기준으로 50% 미만 녹색, 50–79% 황색, 80% 이상 적색입니다. 추가 한도 전체를 합산한 경고는 아닙니다.

마우스를 화면 맨 위에 약 0.6초 두면 SketchyBar가 숨겨지고 macOS 메뉴바를 사용할 수 있습니다.

• 열린 메뉴를 닫고 커서를 아래로 내리면 상단 바가 돌아옵니다.
• 바가 돌아오지 않으면 Esc로 열린 메뉴를 먼저 닫으세요.
• SketchyBar의 팝업이 열려 있으면 메뉴바 전환을 억제합니다.
• README의 ⌃ F2는 macOS 메뉴바 접근 키이며 키보드 설정에 따라 달라질 수 있습니다.

설정은 파일을 편집해 조정합니다. 변경 전에 자신이 관리하는 설정을 별도로 보관하세요.

상단 바: 공급자·갱신 간격·시계

~/.config/sketchybar/sketchybarrc에서 아래 값을 수정합니다.

AI_PROVIDERS="claude codex cursor"
AI_REFRESH=300
CLOCK_POSITION=auto
CLOCK_CENTER_MIN=1800

sketchybar --reload

시계의 auto 기준은 연결된 화면 중 가장 좁은 폭 1800pt입니다. 물리 픽셀 해상도 기준이 아닙니다. 겹치면 CLOCK_POSITION=right로 고정하거나 공급자 수를 줄이세요.

AeroSpace 단축키를 바꾼 뒤

⌘⇧ ; → Esc

서비스 모드의 R은 레이아웃 초기화, F는 플로팅·타일 전환입니다. Backspace는 현재 창을 제외한 창을 닫습니다. 단순 확인용으로 누르지 마세요.

모니터의 기본 배치

기본 관리기는 바 시작·디스플레이 변경·잠자기 해제 시 [workspace-to-monitor-force-assignment] 블록을 다시 씁니다. 수동 배치를 유지하려면 sketchybarrc에서 monitor_ctl 항목의 생성·구독 설정과, 바로 아래 monitor_layout.sh를 실행하는 줄을 함께 제거하세요. 시작 시 실행하는 줄이 남아 있으면 바를 다시 읽을 때 수동 배치가 덮어써집니다. 10초 주기는 바 표시 갱신이며 배치 재작성 주기와 다릅니다.

설치 옵션의 정확한 범위

./install.sh --help

메뉴바 감도 변경

Swift 헬퍼의 revealEdge, restoreBelow, dwell을 수정하고 다시 빌드해야 합니다. 기본값은 화면 좌표 기준 상단 2, 복귀 경계 44, 머무는 시간 0.6초입니다. Retina 화면의 물리 픽셀 수를 뜻하지 않습니다.

별도 개인정보처리방침은 저장소에 없습니다. 아래는 프로젝트 스크립트에서 확인한 범위이며 외부 도구 전체의 처리를 보증하지 않습니다.

설정을 제거하려면

cd ~/omarchy-mac
./uninstall.sh

제거 완료.
패키지까지 지우려면:

• SketchyBar와 AeroSpace의 두 설정 위치에서 가장 최근 백업을 복원합니다.
• 백업이 없는 경로는 현재 설정이 삭제될 수 있습니다. 설치 옵션과 무관하게 세 경로를 처리합니다.
• Homebrew 패키지는 유지됩니다. JankyBorders·CodexBar의 완전 종료도 보장하지 않습니다.
• 이전 바 설정이 없으면 메뉴바를 항상 표시하도록 바꿉니다. 설치 전 자동 숨김 상태를 별도로 저장하지 않습니다.
• 설치 전 환경 전체를 완전히 복원하는 기능은 아닙니다.

표시가 멈추거나 창이 정렬되지 않으면 아래 순서로 원인을 확인하세요. 명령은 직접 진단할 때 사용하며 이 사이트에서 실행하지 않습니다.

codexbar usage --provider claude

sketchybar --trigger ai_usage_refresh

pgrep -l AeroSpace
open -a AeroSpace

sketchybar --reload

brew install --cask font-caskaydia-mono-nerd-font
sketchybar --reload

quit-after-last-window-closed = true