# Pocket Alert CLI 2.1: 푸시 알림 레벨, exec, watch, 터미널 받은편지함

> Pocket Alert CLI를 새로 작성하고 오픈소스로 공개했어요. 레벨, 액션 버튼, 이미지, 예약 발송으로 알림을 보내고, exec로 명령어를 감싸고, watch로 로그 줄을 푸시 알림으로 바꾸며, 전체 화면 터미널 UI에서 모든 것을 살펴볼 수 있어요.

*17.10.2026*

<!-- source: https://pocketalert.app/ko/blog/pocketalert-cli-2 -->

처음 나온 Pocket Alert CLI는 제목과 메시지만 보낼 수 있었어요. 아이디어를 증명하기에는 충분했지만, 우선순위 레벨도, 액션 버튼도, 예약 발송도 없었고, 가장 흔한 용도인 긴 명령어가 끝났을 때 알려주는 기능도 없었어요.

2 버전은 처음부터 다시 작성했어요. MIT 라이선스로 별도 저장소에 있고, 명령어 한 줄로 설치할 수 있으며, API가 할 수 있는 모든 기능을 다뤄요. 오늘 출시된 2.1 버전에서는 `pocketalert ui`가 추가됐어요. 받은편지함, 예약 발송, 애플리케이션, 기기, 웹훅을 한 화면에서 관리할 수 있는 전체 화면 터미널 앱이에요.

![터미널에 표시된 Pocket Alert CLI 받은편지함](https://cdn.pocketalert.app/blog/pocketalert-cli-2-inbox.jpg)

## 설치

**macOS 및 Linux:**

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

**Homebrew:**

```bash
brew install pocketalert/tap/pocketalert
```

**Go:**

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

**Windows:** 최신 릴리스에서 [pocketalert_windows_amd64.zip](https://github.com/PocketAlert/cli/releases/latest/download/pocketalert_windows_amd64.zip)을 내려받은 뒤 `pocketalert.exe`를 PATH에 추가하세요. 모든 릴리스는 체크섬과 함께 Intel 및 ARM용 macOS와 Linux, x64용 Windows 아카이브를 제공해요.

그다음 [API 키](/account/apikeys) 페이지에서 API 키를 발급받아 한 번만 로그인하세요.

```bash
pocketalert auth
```

키는 입력 시 화면에 표시되지 않는 프롬프트에 입력하고, API로 확인한 뒤 `~/.pocketalert/config.json`에 권한 `600`으로 저장돼요. CI에서는 대신 `POCKETALERT_API_KEY`를 설정하세요. 저장된 키보다 우선 적용돼요.

## 보내기, API의 모든 기능과 함께

기본 형태는 이제 인자 두 개예요.

```bash
pocketalert send "Deploy finished" "v1.4.2 is live"
```

메시지는 표준 입력(stdin)에서 받을 수도 있어서, 명령어 출력을 바로 휴대폰으로 보낼 수 있어요.

```bash
df -h | pocketalert send "Disk report"
```

나머지 옵션은 모두 플래그로 지정해요.

- **레벨.** `-l silent|low|default|high|critical`, 또는 `-2`부터 `2`까지. 유료 플랜에서는 `critical`이 방해 금지 모드에서도 전달돼요. 무료 플랜에서는 `high`로 전달돼요.
- **예약 발송.** 계정 시간대 기준으로 `--at "2026-10-20 09:50"`, 또는 `--in 1d12h`를 사용하세요. 유료 플랜에서는 최대 30일 뒤까지 예약할 수 있어요. `pocketalert scheduled list`와 `scheduled cancel <tid>`로 대기 중인 알림을 관리할 수 있어요.
- **액션 버튼.** `--action type:label:value`를 최대 세 개까지 쓸 수 있어요. 여기서 type은 `view`, `http`, `copy` 중 하나예요. 유료 플랜에서 사용할 수 있어요.
- **이미지.** `--image ./screenshot.png` 또는 `https://` URL을 사용하세요. 유료 플랜에서 사용할 수 있어요.
- **대상.** `-a`는 애플리케이션, `-d`는 기기 하나를 지정해요.
- **스크립팅.** `-q`는 메시지 ID만 출력하고, 모든 명령어는 원시 API 응답을 위해 `--json`을 지원해요.

모든 옵션을 한 번에 사용한 배포 실패 알림 예시예요.

```bash
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"
```

`http` 버튼은 기본으로 POST 요청을 보내요. 다른 메서드를 쓰려면 `http:Ack:GET https://…`처럼 작성하거나, 헤더와 본문이 포함된 전체 JSON 형식을 사용하세요.

## exec: 명령어가 끝나면 푸시 알림

많은 사람이 래퍼 스크립트를 따로 만들어 쓰던 기능이 이제 기본으로 들어 있어요. `exec`는 명령어를 실행하고 출력을 평소처럼 보여준 뒤, 명령어가 끝나면 푸시 알림을 보내요.

```bash
pocketalert exec -- ./backup.sh
```

푸시 알림 제목에는 명령어 이름과 함께 ✓ 또는 ✗와 종료 코드가 표시돼요. 본문에는 실행 시간, 호스트 이름, 출력의 마지막 10줄이 들어가요. 레벨을 따로 지정하지 않으면 실패한 경우 `high`로 전송되고, 명령어의 종료 코드가 그대로 전달돼요. 그래서 `exec`는 스크립트, cron, CI에서 안전하게 쓸 수 있어요.

```bash
pocketalert exec --on failure -l critical -- terraform apply -auto-approve
pocketalert exec -t "Nightly import" --tail 20 -- python import.py
```

`--on`은 알림을 보낼 시점을 정해요. `always`, `success`, `failure` 중 하나를 고르세요. `--tail`은 포함할 출력 줄 수를 정하고, `0`이면 출력을 포함하지 않아요.

## watch: 로그 줄을 푸시 알림으로

`watch`는 파이프에서 줄을 읽어 알림으로 보내요.

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

배치 구간(기본 5초) 안에 도착한 줄은 하나의 푸시 알림으로 묶이고, 제목에 줄 수가 표시돼요. 오류 200개가 한꺼번에 발생해도 일일 한도에서 차감되는 건 200개가 아니라 메시지 하나예요.

## pocketalert ui

`pocketalert ui`를 실행하면 터미널이 Pocket Alert 클라이언트로 바뀌어요. `tab` 키 또는 `1`부터 `5`까지의 숫자 키로 전환할 수 있는 탭이 다섯 개 있어요. 받은편지함, 예약, 애플리케이션, 기기, 웹훅이에요.

**받은편지함**에서는 메시지의 레벨, 애플리케이션, 시간이 표시되고, 읽지 않은 메시지에는 점이 찍혀 있어요. 오른쪽 패널에는 선택한 메시지가 전체 내용으로 표시되며, 액션 버튼과 대상도 함께 보여요. `/`로 검색하고, `u`로 읽지 않은 메시지만 보고, `r`로 하나를 읽음 처리하거나 `a`로 전체를 읽음 처리하세요. 앱이 열려 있는 동안에는 새 메시지가 자동으로 나타나요.

![미리보기 패널에 액션 버튼이 있는 메시지](https://cdn.pocketalert.app/blog/pocketalert-cli-2-actions.jpg)

`n`을 누르면 **작성기**가 열려요. 제목과 메시지를 입력한 뒤, 애플리케이션, 기기, 레벨, 전송 시간, 이미지, 최대 세 개의 액션 버튼을 설정할 수 있어요. 액션 버튼은 `type:label:value` 플래그와 같은 `send` 형식으로 입력해요. `ctrl+s`를 누르면 전송돼요. 기존 메시지에서 `f`를 누르면 그 메시지가 작성기에 다시 열려요. 다시 보내거나 템플릿으로 쓸 때 유용해요.

![터미널에서 새 메시지 작성하기](https://cdn.pocketalert.app/blog/pocketalert-cli-2-compose.jpg)

다른 탭에서는 계정의 나머지 항목을 관리해요. **애플리케이션** 탭에서는 각 애플리케이션과 기본 레벨을 확인할 수 있어요. 키보드를 떠나지 않고 만들기, 이름 변경, 레벨 변경, 삭제를 할 수 있고, `enter`를 누르면 해당 애플리케이션의 메시지를 볼 수 있어요. **기기** 탭에서는 휴대폰 목록을 보고 이름을 바꾸거나 삭제할 수 있어요. **웹훅** 탭에서는 웹훅 목록과 요청 기록을 확인할 수 있고, `y`를 누르면 웹훅 URL이 복사돼요. **예약** 탭에서는 대기 중인 알림을 확인하고 `d`로 취소할 수 있어요.

![터미널 UI의 애플리케이션 화면](https://cdn.pocketalert.app/blog/pocketalert-cli-2-applications.jpg)

삭제처럼 되돌리기 어려운 작업은 실행 전에 항상 확인을 요청해요. `?`를 누르면 전체 단축키 목록이 표시돼요.

## 스크립트에서 계정 관리하기

API의 나머지 기능도 모두 지원하며, 모든 명령어에서 `--json`을 사용할 수 있어요.

```bash
pocketalert usage                                   # today's quota
pocketalert messages list -n 20
pocketalert messages read --all
pocketalert apps create -n "Production" -c "#EF4444" -l high
pocketalert webhooks create -n Grafana -m "%title%: %message%" -l high
pocketalert webhooks history <tid> --status error
pocketalert devices rename <tid> "Work phone"
```

이제 CLI에서 애플리케이션과 웹훅의 기본 레벨을 설정할 수 있어요. 또한 웹훅에 액션 버튼을 추가할 때 `%field.path%` 플레이스홀더를 쓰면 페이로드 값으로 채울 수 있어요. 예를 들어 Grafana 경고를 `high` 레벨로 받으면서, 정확히 해당 패널을 여는 버튼을 함께 받을 수 있어요.

`pocketalert completion`으로 zsh, bash, fish용 셸 자동 완성을 설정할 수 있어요.

## 1.x에서 업그레이드하기

위의 방법 중 하나로 2.1을 설치하세요. 기존 바이너리를 대체하고, 저장된 키도 그대로 유지돼요. 기존 스크립트에 영향을 줄 수 있는 변경 사항은 세 가지예요.

- **메시지가 이제 필수예요.** `pocketalert send -t "Cron OK"` 없이 `-m`를 실행하면 오류가 나요. 메시지를 추가하거나, 파이프로 입력하거나, 메시지를 자동으로 만들어 주는 `exec`를 사용하세요.
- **두 형식을 섞어 쓰지 마세요.** `send "Title" "Message"` 또는 `send -t "Title" -m "Message"` 중 하나만 사용하세요. `send -t "Title" "Message"`에서는 두 번째 인자가 제목으로 읽히고, 그 뒤는 무시돼요.
- **생성된 텍스트에는 `-m`을 사용하세요.** AI 에이전트가 만든 Markdown 목록처럼 대시(-)로 시작하는 위치 인자 메시지는 옵션으로 해석돼요. `-m "$text"`는 항상 안전해요.

프로비저닝 스크립트에서 릴리스 아카이브를 내려받는다면 이름이 `pocketalert_<os>_<arch>.tar.gz`로 바뀌었어요. Windows에서는 `.zip`이에요.

1.x의 여러 버그도 함께 수정했어요. `webhooks create`가 이제 `--application`과 `--device`를 따르고, 웹훅 URL이 올바른 호스트를 가리키며, 오류가 stdout 대신 stderr로 출력돼요. 한글 같은 비라틴 문자 제목이 글자 중간에서 잘리지 않고, 일일 한도에 도달하면 단순한 `429` 대신 사용량과 초기화 시간이 표시돼요.

## 어디에 쓰면 좋을까요

CLI는 이제 터미널에서 휴대폰까지 가장 짧게 연결하는 방법이에요. 이 블로그의 가이드에서도 코드 줄을 줄일 수 있는 곳에서는 CLI를 사용해요. 코딩 에이전트의 경우, [Claude Code](/blog/claude-code-push-notifications), [Codex](/blog/codex-notifications), [Cline 및 Aider](/blog/cline-aider-notifications) 가이드의 훅 스크립트에서 curl 대신 `pocketalert send`를 호출할 수 있어요. cron과 CI에서는 `exec`가 대부분의 `|| curl` 한 줄짜리 명령을 대체해요.

[CLI 설치하기](/tools/cli)에서 시작하고, `pocketalert auth`를 실행한 뒤 `pocketalert ui`를 사용해 보세요.
