문서의 모든 페이지를 검색하려면 두 글자 이상 입력하세요.

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

알림

rdev는 AI 에이전트가 사용자를 필요로 할 때 알려 줍니다. 서버에서 에이전트에게 작업을 맡기고 노트북을 닫아도, 에이전트가 작업을 끝내거나 승인을 기다리거나 오류가 발생하면 휴대폰으로 알림을 받습니다.

작동 방식

알림은 서버에서 사용자가 소유한 채널로 직접 전송됩니다. rdev의 서버를 거치지 않으므로 에이전트가 작성한 텍스트는 사용자의 서버와 사용자 사이에서만 오갑니다.

모든 요금제에 알림이 포함됩니다.

요금제 채널
Single 개인 채널 1개
Pro 여러 채널
Team 사용자별 채널과 공유 팀 채널

이벤트

알림을 받을 이벤트를 선택할 수 있습니다.

  • 작업을 끝냈을 때: 에이전트가 작업을 완료했습니다.
  • 승인을 기다릴 때: 에이전트가 사용자의 권한이 필요한 명령어를 실행하려고 합니다.
  • 오류: 문제가 발생해 에이전트가 중지되었습니다.

지원하는 채널

  • ntfy: 기본으로 권장하는 채널입니다. 무료이고 계정이 필요 없으며 휴대폰 앱이 있고 직접 운영하는 서버에서도 실행할 수 있습니다.
  • Gotify: 자체 호스팅 알림 서버입니다.
  • Telegram: 직접 만든 봇이 보내는 메시지입니다.
  • Slack과 Discord: 수신 웹훅을 통해 채널로 보내는 메시지입니다.
  • Pushover: 기기로 보내는 푸시 알림입니다.
  • 웹훅: 원하는 URL로 보내는 JSON 이벤트로, 직접 만든 연동에 사용합니다.

메시지 내용

기본적으로 알림은 에이전트의 텍스트 없이 "rdev · myapp · finished" 같은 짧은 요약입니다. 원하면 전체 메시지로 전환할 수 있습니다. 에이전트의 마지막 응답이 포함되며, 비밀 값으로 보이는 내용(API 키, 토큰, 비밀번호, 개인 키)은 가려지고 텍스트는 안전한 길이로 줄어듭니다.

지원하는 에이전트

Claude Code와 Codex는 기본적으로 알림을 보냅니다. rdev가 관리형 설정을 통해 연결하므로 설정이 그대로 유지됩니다. 다른 에이전트도 훅을 지원하거나 끝날 때 명령어를 실행할 수 있다면 알림을 보낼 수 있습니다.

패널에서 설정

사이드바의 서버에서 서버를 열고 접근을 선택하세요. 알림 카드에서 채널 추가를 누르면 ntfy가 선택된 채널 양식이 열립니다.

  1. 양식이 아무도 추측할 수 없는 무작위 토픽 이름을 만듭니다. 휴대폰에 ntfy 앱을 설치하고 **+**를 눌러 해당 토픽을 구독하거나, 그 아래에 표시된 https://ntfy.sh/<topic> 링크를 휴대폰에서 열거나, 휴대폰 카메라로 QR 코드를 스캔하세요. QR 코드는 브라우저에서 그려지며 토픽은 패널에 전달되지 않습니다. 직접 운영하는 ntfy 서버라면 주소를 입력하고, 필요하면 액세스 토큰도 입력하세요.
  2. 암호화하여 저장을 선택하세요. 채널의 설정(토픽, 토큰, 웹훅 URL)은 브라우저에서 이 서버용으로 암호화되며, 패널은 내용을 볼 수 없고 나중에 표시할 수도 없습니다. 카드에는 각 채널의 짧은 라벨만 표시되며, 채널을 변경하려면 설정을 다시 입력해야 합니다. 변경에서는 채널을 다른 유형(예: ntfy 대신 Gotify)으로 전환할 수도 있으며, 채널이 하나뿐인 Single 요금제에서는 이렇게 유형을 바꿉니다.
  3. 채널의 테스트 보내기를 선택하세요. "전송됨" 같은 서버의 응답이나 실패 이유가 페이지에 표시됩니다.

Gotify, Telegram, Slack, Discord, Pushover, 웹훅은 양식에서 선택하고 설정을 입력하세요. 채널 아래에서 이벤트(완료, 승인 대기, 오류)와 에이전트의 마지막 응답 포함 여부를 선택합니다. Single 요금제는 채널 하나로 전송하며, Pro와 Team은 채널을 더 추가할 수 있습니다. 대시보드의 설정 가이드에는 서버에 채널이 생기면 체크되는 선택 단계 휴대폰으로 알림 받기가 있습니다. 이 기능에는 rdev 0.2.0-beta.36 이상이 필요하며, 서버가 해당 버전을 실행할 때까지 카드에서 업데이트하라고 안내합니다.

서버에서 설정

서버에서 채널을 설정할 수도 있습니다. ntfy가 가장 빠릅니다. 휴대폰에 앱을 설치하고 아무도 추측할 수 없는 토픽 이름을 정한 뒤 다음을 실행하세요.

sudo rdev notify setup ntfy --topic my-secret-topic

그다음 테스트 메시지를 보내 도착하는지 확인하세요.

rdev notify test

직접 운영하는 ntfy 서버에는 --server https://ntfy.example.com을, 토큰이 필요하면 --token을 추가하세요. Gotify, Telegram, Slack, Discord, Pushover, 웹훅 채널은 rdev notify setup이 만드는 /etc/rdev/notify.toml에 넣습니다. AI 에이전트가 채널을 추가하고 테스트를 보내 줄 수도 있습니다. Pro와 Team에서는 여기에 여러 채널을 나열할 수 있으며, Single은 첫 번째 채널로 전송합니다.

채널에 연결할 수 없어도 다른 채널은 알림을 받고 에이전트는 계속 작업합니다. 알림 문제로 작업이 중단되는 일은 없습니다.

패널의 알림

직접 설정한 채널 외에도, 패널은 사이드바의 알림에 같은 이벤트의 짧은 목록을 읽지 않은 개수와 함께 보관합니다. 휴대폰에서는 위쪽의 종 아이콘으로 열 수 있습니다. 목록에는 프로젝트, 에이전트, 일어난 일(응답 대기, 완료, 오류로 중지)과 서버만 표시되며 에이전트가 쓴 텍스트는 절대 표시되지 않습니다. 하나를 탭하면 해당 화면이 열립니다. 목록을 열면 모두 읽음으로 표시됩니다. 몇 개를 선택해 삭제하거나 모두 삭제를 사용하세요. 알림은 30일 동안 보관됩니다. 서버를 관리하는 모든 사람이 받으므로 Team 플랜에서는 소유자와 관리자가 멤버의 에이전트 알림도 봅니다.