명령줄 인터페이스

푸시 알림, 터미널에서 바로.

스크립트, 크론 작업, CI/CD에서 알림을 보내거나 전체 화면 터미널 UI로 받은 알림을 확인하세요. 의존성 없는 단일 정적 바이너리예요.

<1s 후 푸시 알림단일 바이너리 · 의존성 없음Linux · macOS · Windows오픈 소스 · MIT
# Fire a notification from anywhere
pocketalert send "Deploy finished" "v2.4.0 is live 🚀"
✓ Sent

# Critical alert with buttons — gets through Do Not Disturb
pocketalert send "Deploy failed" "main@4f2c" -l critical \
  --action "view:Open logs:https://ci.example.com/run/1" \
  --action "http:Retry:https://ci.example.com/run/1/retry"
✓ 전송됨 · 레벨 · 버튼 · 이미지 · 예약 발송
주요 기능

API 전체를 명령어 하나로

Pocket Alert의 모든 기능을 셸, 스크립트, 파이프라인 등 이미 쓰고 있는 도구에 바로 연결하세요.

대화형 모드

pocketalert ui를 실행하면 전체 화면 받은 알림함이 열려요. 검색하고, 읽고, 레벨과 버튼을 넣어 작성하고, 애플리케이션·기기·웹훅을 관리할 수 있어요.

스크립트에 최적화

어떤 스크립트, Makefile, 한 줄 명령에도 알림을 넣을 수 있어요. 브라우저도 대시보드도 필요 없이 셸만 있으면 돼요.

크로스 플랫폼

Linux, macOS(Intel 및 Apple Silicon), Windows용 단일 정적 바이너리예요. 런타임도 의존성도 필요 없어요.

CI/CD를 위해 설계

GitHub Actions, GitLab CI, Jenkins 등 어떤 파이프라인에도 알림을 연결하세요. 한 번 인증하면 어디서든 보낼 수 있어요.

API 전체 기능 지원

critical까지의 우선순위 레벨, 액션 버튼, 이미지 첨부, --at 또는 --in을 이용한 예약 발송을 지원해요.

작업 완료를 바로 확인

pocketalert exec로 아무 명령이나 감싸면 종료 코드, 소요 시간, 출력 마지막 줄이 담긴 푸시를 받을 수 있어요.

기본부터 안전하게

API 키는 숨김 프롬프트로 입력하고 600 권한으로 저장해요. CI에서는 POCKETALERT_API_KEY로 전달하세요.

1초 이내 전달

푸시가 1초 안에 휴대폰에 도착해요. 모니터링 스크립트, 배포, 시스템 알림에 딱 맞아요.

대화형 모드

터미널 속 받은 알림함

pocketalert ui를 실행해 메시지를 검색하고 읽고, 레벨·예약·액션 버튼을 넣어 새 메시지를 작성하고, 애플리케이션·기기·웹훅까지 키보드만으로 관리하세요.

pocketalert ui
Pocket Alert CLI 대화형 모드: 메시지 미리보기가 있는 받은 알림함
시작하기

세 단계로 첫 푸시 보내기

1

CLI 설치

한 줄 설치 스크립트를 실행하거나 Homebrew를 쓰거나, 아래에서 사용하는 플랫폼에 맞는 바이너리를 다운로드하세요.

2

인증

pocketalert auth를 한 번 실행하고 API 키를 붙여넣으세요. CI에서는 대신 POCKETALERT_API_KEY를 설정하세요.

3

첫 푸시 보내기

pocketalert send "Title" "Message"를 실행하면 잠시 후 휴대폰이 울려요.

다운로드

바이너리 다운로드

플랫폼과 아키텍처를 선택하세요. 미리 빌드되어 있어 PATH에 바로 넣어 쓸 수 있어요.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

모든 릴리스, 체크섬, 소스 코드는 GitHub에서 확인하세요.

설치

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | sh

Homebrew로 설치하려면:

brew install pocketalert/tap/pocketalert

스크립트가 SHA-256 체크섬을 확인해요. 버전을 고정하려면 POCKETALERT_VERSION=v2.1.0을 설정하세요.

Windows

압축을 풀고 pocketalert.exe가 있는 폴더를 PATH 환경 변수에 추가하세요.

Go

go install github.com/PocketAlert/cli/cmd/pocketalert@latest

그다음 pocketalert version을 실행해 잘 동작하는지 확인하세요.

빠른 시작

1. 인증

pocketalert auth

API 키 페이지에서 API 키를 발급받으세요. 키는 ~/.pocketalert/config.json에 안전하게 저장돼요.

2. 알림 보내기

pocketalert send "Hello" "It works 🎉"

CI와 컨테이너에서는 auth를 건너뛰고 POCKETALERT_API_KEY를 설정하세요.

예시

레벨, 버튼, 이미지

pocketalert send "Disk 95%" "/var is almost full" --level high
pocketalert send "Deploy failed" "main@4f2c" -l critical \
  --action "view:Open logs:https://ci.example.com/run/1" \
  --action "http:Retry:https://ci.example.com/run/1/retry" \
  --action "copy:Copy SHA:4f2c9e1"
pocketalert send "Grafana" "CPU spike" --image ./panel.png

레벨은 silent부터 critical까지예요. 버튼 유형은 view(URL 열기), http(웹훅 호출), copy이며 메시지당 최대 세 개까지 넣을 수 있어요.

파이프로 메시지 전달

df -h | pocketalert send "Disk report"
pocketalert send -t "AI summary" -m "$SUMMARY"      # safe for text that starts with "-"

예약 발송

pocketalert send "Standup" "In 10 minutes" --at "2026-10-20 09:50"
pocketalert send "Reminder" "Rotate the keys" --in 1d12h
pocketalert scheduled list
pocketalert scheduled cancel <tid>

명령이 끝나면 알림 받기

pocketalert exec -- make release
pocketalert exec --on failure -l critical -- ./backup.sh
pocketalert exec -t "Nightly import" --tail 20 -- python import.py

✓ 또는 ✗, 소요 시간, 출력 마지막 줄이 담긴 푸시를 받아요. 종료 코드는 그대로 전달되므로 CI와 exec 스크립트에서도 set -e를 안전하게 쓸 수 있어요.

로그 감시

tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l high

--batch(기본 5초) 안에 들어온 줄은 푸시 하나로 묶여요. 오류가 한꺼번에 쏟아져도 일일 한도는 메시지 한 건만 차감돼요.

스크립트 활용

TID=$(pocketalert send "Build" "started" -q)       # print only the TID
pocketalert messages list --json | jq -r '.data[].title'
pocketalert usage                                   # today's quota

모든 명령이 --json을 지원하고, 오류는 stderr로 출력되며, 종료 코드도 믿을 수 있어요. critical 알림, 버튼, 이미지, 예약 발송은 유료 플랜이 필요해요. 무료 플랜에서도 메시지는 전달되고, CLI가 빠진 항목을 알려줘요.

메시지, 애플리케이션, 기기, 웹훅, 폼, API 키 등 모든 명령과 플래그는 CLI 문서에서 확인하세요.

FAQ

궁금한 점에 답해 드려요

Pocket Alert CLI는 스크립트, 크론 작업, CI에서 휴대폰으로 푸시 알림을 보내는 오픈 소스 명령줄 도구예요. 명령을 감싸 끝나면 알려주고, 로그 줄을 알림으로 바꾸고, 브라우저 없이 메시지, 애플리케이션, 기기, 웹훅, 폼, API 키를 관리할 수 있어요.

네. pocketalert ui를 실행하면 터미널에서 전체 화면 앱이 열려요. 받은 알림함 탐색과 검색, 액션 버튼이 포함된 메시지 읽기, 레벨·예약·이미지·버튼을 넣은 새 메시지 작성, 예약 메시지·애플리케이션·기기·웹훅 관리가 가능해요. 새 메시지는 자동으로 나타나고, ?를 누르면 모든 단축키를 볼 수 있어요.

CLI를 설치한 뒤 pocketalert auth를 실행하고 프롬프트에 API 키를 붙여넣으세요. API 키는 API 키 페이지에서 만들 수 있어요. CLI가 키를 확인한 다음 ~/.pocketalert/config.json에 저장해요. CI에서는 대신 POCKETALERT_API_KEY를 설정하세요.

Pocket Alert CLI는 Linux(AMD64, ARM64), macOS(Intel, Apple Silicon), Windows(AMD64)용으로 제공돼요. 지원하는 모든 플랫폼에 미리 빌드된 바이너리가 있어요.

pocketalert send "Title" "Message"로 보내세요. --level critical, 최대 세 개의 --action 버튼, --image를 추가하거나 --at / --in으로 예약할 수 있어요.

물론이에요. CLI는 CI/CD를 염두에 두고 만들었어요. POCKETALERT_API_KEY를 시크릿으로 설정하고 pocketalert send를 호출하거나, pocketalert exec -- make deploy처럼 단계를 감싸 결과를 휴대폰으로 받아보세요.

아니요. 전송, exec, watch, 대화형 모드는 무료 플랜에서도 사용할 수 있어요. critical 레벨, 액션 버튼, 이미지, 예약 발송은 유료 플랜이 필요해요. 무료 플랜에서도 메시지는 전달되고, CLI가 빠진 항목을 알려줘요.

네. CLI는 API 키를 700 권한으로 만든 설정 디렉터리 안의 ~/.pocketalert/config.json에 파일 권한 600으로 저장해요. 모든 통신은 HTTPS로 이뤄지고, 키는 Token 헤더로 전송돼요.

이제 터미널이 알림 채널이 돼요

바이너리를 다운로드하고 한 번만 인증하면, 1분 안에 터미널에서 첫 푸시를 보낼 수 있어요.