컨텐츠로 건너뛰기
쇼케이스 생태계 소스 코드 문서

Opencode Notify

Opencode Notify

Opencode Notify는 OpenCode 작업이 완료되거나, 오류가 발생하거나, AI가 사용자 입력이 필요할 때 네이티브 OS 알림을 전송합니다. 다른 작업에 집중하다가 AI가 완료되거나 주의가 필요할 때 알림을 받을 수 있습니다.

주요 기능

기능설명
집중 유지다른 앱에서 작업하다가 AI가 필요할 때 알림 수신
네이티브 OS 알림macOS 알림 센터, Windows Toast, Linux notify-send
스마트 기본값방해 금지 시간 지원과 함께 의미 있는 이벤트에만 알림
터미널 포커스 감지터미널이 활성 상태일 때 알림 억제 (macOS)
클릭으로 포커스알림 클릭 시 터미널을 전경으로 가져옴 (macOS)
37개 이상 터미널 지원Ghostty, Kitty, iTerm2, WezTerm, Alacritty, VS Code 등

알림 이벤트

이벤트알림 여부소리이유
세션 완료예Glass메인 작업 완료
세션 오류예Basso문제 발생
권한 필요예SubmarineAI가 차단됨
질문예Submarine직접 프롬프트가 즉시 전달됨
하위 작업 완료/오류아니요 (기본값)—notifyChildSessions: true로 활성화

플랫폼 지원

기능macOSWindowsLinux
네이티브 OS 알림지원지원지원
사용자 지정 소리지원미지원미지원
포커스 감지지원미지원미지원
클릭으로 포커스지원미지원미지원
터미널 감지지원지원지원

설치

KDCO 레지스트리 통해 설치 (권장)

ocx add kdco/notify --from https://registry.kdco.dev

또는 전체 워크스페이스 번들 설치:

ocx add kdco/workspace --from https://registry.kdco.dev

수동 설치

플러그인 파일을 다중 파일 레이아웃을 유지하며 .opencode/plugins/에 복사합니다. node-notifier 및 detect-terminal 의존성이 필요합니다.

설정

설정 파일: ~/.config/opencode/kdco-notify.json

{
  "notifyChildSessions": false,
  "terminal": "ghostty",
  "sounds": {
    "idle": "Glass",
    "error": "Basso",
    "permission": "Submarine",
    "question": "Submarine"
  },
  "quietHours": {
    "enabled": false,
    "start": "22:00",
    "end": "08:00"
  }
}

설정 옵션

키기본값설명
notifyChildSessionsfalse하위/서브 세션 알림 포함
terminal자동 감지터미널 자동 감지 재정의
sounds이벤트별 기본값이벤트별 소리 (idle, error, permission, question)
quietHours비활성화예약된 알림 억제 시간

사용 가능한 macOS 소리: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink.

링크