macOS 메뉴 막대 상태 표시기 추가
NanoClaw의 실행 상태를 macOS 메뉴 막대에서 보고 시작·중지·재시작까지 할 수 있게 해주는 설치 스킬입니다.
유틸리티중급★ 30,471⑂ 12,865AI 점수 6/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Docker Desktop처럼 macOS 상단 메뉴 막대에 상주하는 작은 번개 아이콘을 추가합니다. 아이콘 옆 점의 색으로 NanoClaw 서비스 상태를 알려주고(초록=실행 중, 빨강=중지), 클릭하면 Start / Stop / Restart, 로그 보기 메뉴를 바로 쓸 수 있습니다.
동작 흐름은 세 단계로 정리되어 있습니다.
- 사전 점검 — macOS 여부 확인,
swiftc(Xcode Command Line Tools) 설치 여부 확인, 이미 설치되어 있는지launchctl로 확인 - 컴파일 및 설치 — 스킬에 포함된 Swift 소스를
dist/statusbar로 빌드하고, 격리 속성(quarantine)을 해제한 뒤~/Library/LaunchAgents에 launchd plist를 만들어 로드 - 검증 —
launchctl list로 PID가 잡히는지 확인하고 사용자에게 사용법 안내
제거 방법은 별도의 REMOVE.md 문서로 안내합니다.
이런 분께 추천
- NanoClaw를 macOS에서 상시 돌리며 상태를 눈으로 바로 확인하고 싶은 분
- 터미널에서
launchctl,ps명령을 매번 치는 게 번거로운 분 - 로컬 백그라운드 서비스를 메뉴 막대에서 제어하는 패턴을 참고하고 싶은 개발자
활용 예시
- 최초 설치: NanoClaw 프로젝트 루트에서
/add-macos-statusbar를 실행하면 Swift 바이너리를 빌드하고 로그인 시 자동 실행되는 launchd 에이전트까지 한 번에 등록합니다. - 코드 수정 후 재시작: 소스를 고친 뒤 메뉴 막대 아이콘을 눌러 Restart를 선택하면 터미널로 돌아가지 않고 서비스를 다시 올릴 수 있습니다.
- 장애 확인: 점이 빨간색으로 바뀌었을 때 메뉴의 View Logs로
logs/statusbar.error.log를 바로 열어 원인을 확인합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-macos-statusbar 폴더를 내 ~/.claude/skills/add-macos-statusbar/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && cp -r /tmp/nanoclaw/.claude/skills/add-macos-statusbar ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- macOS인지 확인합니다. 이 스킬은 macOS 전용이며 Windows·Linux에서는 동작하지 않습니다.
- 터미널에서
which swiftc를 실행합니다. 결과가 없으면xcode-select --install로 Xcode Command Line Tools를 먼저 설치하세요. - 스킬을 내려받아 사용자 스킬 폴더에 복사합니다.
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw mkdir -p ~/.claude/skills cp -r /tmp/nanoclaw/.claude/skills/add-macos-statusbar ~/.claude/skills/ - NanoClaw 프로젝트 폴더에서 Claude Code를 실행합니다. (빌드 산출물이 프로젝트의
dist/에 생기므로 프로젝트 루트에서 실행하는 것이 중요합니다.) /add-macos-statusbar를 입력하거나 "macOS 메뉴 막대 상태 표시기를 추가해줘"라고 요청합니다.- Claude가 제안하는 컴파일·
launchctl load명령을 확인하고 승인합니다. - 메뉴 막대에 번개 아이콘이 나타나는지,
launchctl list | grep com.nanoclaw.statusbar결과에 PID가 보이는지 확인하면 완료입니다. - 제거하려면 스킬 폴더의 REMOVE.md 안내를 따르세요.
GitHub에서 원본 보기 ↗라이선스: MIT