# Cline·Aider 푸시 알림: 차례가 언제 오는지 휴대폰으로 확인하기

> 오픈소스 코딩 에이전트 두 가지의 휴대폰 푸시 알림 설정. Cline은 TaskComplete 훅과 Pocket Alert MCP 서버를, Aider는 .aider.conf.yml의 한 줄 설정을 사용합니다.

*16.10.2026*

<!-- source: https://pocketalert.app/ko/blog/cline-aider-notifications -->

Cline과 Aider는 사람들이 백그라운드에 가장 자주 띄워 두는 오픈소스 코딩 에이전트입니다. 두 도구 모두 확인할 것이 생기면 명령을 실행할 수 있지만, 그 자체로 휴대폰에 아무것도 보내지는 않습니다. 몇 줄의 설정만 바꾸면 됩니다.

- **Cline**은 작업이 끝나면 훅 스크립트를 실행하고 MCP를 지원하므로, 직접 작성한 푸시 알림도 보낼 수 있습니다.
- **Aider**는 응답이 끝난 뒤나 예/아니요 확인을 요청하기 전처럼 입력을 기다릴 때 알림 명령을 실행합니다.

두 도구 모두 Pocket Alert를 통해 발송하므로, 실행 중인 다른 서비스의 알림과 같은 앱, 같은 기록에 쌓입니다.

## 준비물

- Pocket Alert 계정, [API 키](/account/apikeys) 페이지에서 발급받은 API 키, 그리고 [iPhone 또는 Android](/get-app) 휴대폰에 설치한 앱. 무료 플랜으로 충분합니다.
- `curl`, 그리고 Cline 훅에 필요한 `jq`.

키는 파일에 저장해 두세요. macOS에서 Dock으로 실행한 편집기는 셸 프로필을 읽지 않으므로, 파일이 두 에이전트 모두 항상 찾을 수 있는 유일한 위치입니다.

```bash
mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key
```

## Cline

### 작업 완료 훅 설정

Cline 훅은 이벤트 이름을 딴 실행 파일입니다. 확장자 없이 `TaskComplete`라는 스크립트를 `~/Documents/Cline/Hooks/`에 두면, 어떤 워크스페이스에서든 작업이 끝날 때마다 Cline이 이 스크립트를 실행합니다. 특정 프로젝트에만 적용하려면 저장소의 `.clinerules/hooks/TaskComplete`를 사용하세요.

스크립트는 표준 입력(stdin)으로 JSON 객체를 받습니다. `TaskComplete`에서 중요한 필드는 Cline의 최종 응답인 `taskComplete.taskMetadata.result`와 열려 있는 폴더 목록인 `workspaceRoots`입니다. `initialTask` 필드도 있지만 현재 확장 버전은 이 값을 비워서 보냅니다.

```bash
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspaceRoots[0] // "Cline"' <<<"$payload")")
result=$(jq -r '.taskComplete.taskMetadata.result // "" | if . == "" then "Done" else . end' <<<"$payload")

jq -n --arg t "Cline finished · $project" --arg m "${result:0:300}" \
  '{title: $t, message: $m}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{"cancel":false,"contextModification":"","errorMessage":""}'
```

```bash
mkdir -p ~/Documents/Cline/Hooks
# save the script above as ~/Documents/Cline/Hooks/TaskComplete, then:
chmod +x ~/Documents/Cline/Hooks/TaskComplete
```

마지막 줄은 Cline에 돌려주는 훅 응답입니다. 작업을 취소하지 않고, 컨텍스트에 아무것도 추가하지 않고, 오류도 없다는 뜻입니다. 훅은 30초 제한이 있어서 curl은 5초 뒤에 포기하도록 했습니다.

훅이 켜져 있는지 확인하세요. Cline 기능 설정의 **Hooks** 토글은 기본적으로 켜져 있습니다. 훅은 macOS와 Linux에서 셸 스크립트로 실행되며, Windows에서는 `TaskComplete.ps1`이라는 PowerShell 스크립트를 사용합니다.

### "Cline이 승인을 기다리고 있어요"는 어떻게 하나요?

Cline의 훅 목록에는 바로 이 경우를 위한 `Notification` 이벤트가 있지만, 현재 4.x 확장 버전에서는 정의만 되어 있고 아직 호출되지 않습니다. 그때까지는 승인 요청에 쓸 믿을 만한 훅이 없습니다. 자동 승인된 도구를 포함해 모든 도구 실행 전에 `PreToolUse`가 발생하기 때문입니다. 자리를 비우고 싶다면, 안전한 작업에 대해 Cline의 자동 승인 설정을 넓히고 작업이 끝났을 때 `TaskComplete`가 알려주도록 하는 방법이 현실적입니다.

### MCP 서버

Cline은 MCP 클라이언트이므로 [Pocket Alert MCP 서버](/tools/mcp)를 통해서도 푸시를 보낼 수 있습니다. Cline의 MCP 설정 파일인 `~/.cline/data/settings/cline_mcp_settings.json`에 추가하세요.

```json
{
  "mcpServers": {
    "pocketalert": {
      "type": "streamableHttp",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": ["create_message"]
    }
  }
}
```

`type`은 명시적으로 적어 주세요. 없으면 Cline이 이전 방식인 SSE 전송을 가정해서 연결이 실패합니다. `autoApprove`를 설정하면 Cline이 먼저 묻지 않고 푸시를 보낼 수 있는데, 자리를 비웠을 때 바로 이 기능이 필요합니다. 최근 Cline 버전은 VS Code 확장, CLI, JetBrains에서도 같은 파일을 읽습니다.

그다음 `.clinerules`에 지침을 추가하세요.

```text
When you finish a task that took more than a few minutes, call the pocketalert
create_message tool with a one-line summary. Use level "high" if something failed.
```

## Aider

Aider에는 알림 기능이 기본으로 들어 있습니다. `--notifications` 옵션을 쓰면 입력을 기다릴 때 데스크톱 알림을 띄우거나 터미널 벨을 울리고, `--notifications-command`를 쓰면 그 대신 원하는 명령을 실행합니다. 휴대폰 푸시를 보내려면 이것만 있으면 됩니다.

### 명령 만들기

Aider는 인수 없이 셸을 통해 명령을 실행하므로, 스크립트는 자신이 볼 수 있는 정보로 메시지를 구성합니다. 현재 디렉터리가 Aider가 작업하는 저장소입니다.

```bash
#!/usr/bin/env bash
project=$(basename "$PWD")

curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
  -H "Token: $(cat ~/.config/pocketalert/key)" \
  -H 'Content-Type: application/json' \
  -d "{\"title\": \"Aider is waiting · $project\", \"message\": \"Your turn: reply or confirm in the terminal.\"}" \
  >/dev/null 2>&1 || true
```

`~/.config/pocketalert/aider-notify.sh`로 저장한 뒤 `chmod +x`를 실행하세요.

[Pocket Alert CLI](/tools/cli) 2.0 이상을 설치하고 인증해 두었다면, 스크립트 없이 아래 설정에 명령을 바로 넣을 수 있습니다.

```yaml
notifications-command: 'pocketalert send -t "Aider is waiting · $(basename "$PWD")" -m "Your turn, reply or confirm in the terminal" -q'
```

작은따옴표는 YAML이 나머지 줄을 해석하지 않도록 막아 줍니다. Aider는 이 값을 그대로 셸에 넘깁니다.

### 켜기

`~/.aider.conf.yml`에 두 줄을 추가하거나, 저장소의 `.aider.conf.yml`에 추가하세요.

```yaml
notifications: true
notifications-command: ~/.config/pocketalert/aider-notify.sh
```

한 번만 실행하려면 다음과 같이 하세요.

```bash
aider --notifications --notifications-command ~/.config/pocketalert/aider-notify.sh
```

### 언제 울리나요

Aider는 모델이 응답할 때마다 알림을 한 번 보내며, 그 뒤 처음으로 입력을 기다리는 순간에 보냅니다. 보통은 파일 편집을 마친 뒤 나오는 일반 프롬프트입니다. 가장 먼저 필요한 것이 "Add file to the chat?"나 "Run shell command?" 같은 확인 요청이라면, 그 요청에 대해 푸시가 옵니다. 이것이 "승인 대기" 상황입니다. 같은 대화 안에서 이어지는 확인 요청에는 푸시를 다시 보내지 않습니다.

Aider는 MCP를 지원하지 않으므로 알림 명령을 쓰는 방법이 유일합니다. 이것만으로도 충분합니다. Aider는 응답할 때마다 입력을 기다리고, 바로 그 순간에 알고 싶은 것이기 때문입니다.

## 휴대폰에 도착하는 알림

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>에이전트</th><th>제목</th><th>본문</th></tr></thead>
<tbody>
<tr><th>Cline</th><td>Cline finished · api</td><td>Cline 결과의 처음 300자</td></tr>
<tr><th>MCP를 통한 Cline</th><td>에이전트가 작성한 내용</td><td>에이전트가 골라서 보낸 요약</td></tr>
<tr><th>Aider</th><td>Aider is waiting · api</td><td>Your turn: reply or confirm in the terminal.</td></tr>
</tbody>
</table>
</div>

메시지는 기본적으로 보통 우선순위로 전송됩니다. iPhone의 집중 모드에서도 알림을 받고 싶다면 JSON에 `"level": "high"`를 추가하세요. 조용히 받고 싶다면 `"low"`로 설정한 뒤 돌아와서 기록을 확인하면 됩니다.

## 알림이 오지 않을 때

- **스크립트를 직접 실행해 보세요.** Cline은 `echo '{}' | ~/Documents/Cline/Hooks/TaskComplete`, Aider는 `~/.config/pocketalert/aider-notify.sh`를 실행합니다. 그래도 푸시가 없다면 키나 네트워크 문제입니다. `>/dev/null 2>&1`을 지우면 curl의 응답을 볼 수 있습니다.
- **파일 이름을 확인하세요.** Cline은 파일 이름으로 훅을 찾습니다. 정확히 `TaskComplete`여야 하고, 실행 권한이 있어야 하며, `.sh` 확장자가 없어야 합니다.
- **Aider 설정 키를 확인하세요.** Aider의 예시 설정처럼 하이픈이 있는 `notifications-command`를 사용해야 합니다.

## FAQ

### 두 에이전트를 모두 써야 하나요?

아니요. 두 섹션은 서로 독립적입니다. 사용하는 쪽만 설정하면 됩니다.

### Cline이나 Aider가 제 API 키를 볼 수 있나요?

훅과 알림 명령은 키를 파일에서 읽으며, 대화 내용에는 포함되지 않습니다. MCP 설정에 키가 들어가는 이유는 Cline이 서버에 연결할 수 있도록 하기 위해서이며, 모델에는 전송되지 않습니다.

### 키보드 앞에 있을 때도 Aider가 알림을 너무 많이 보내나요?

응답마다 푸시가 하나씩 갑니다. 자리에 앉아 있을 때 이것이 너무 많다면, `--notifications` 없이 Aider를 실행하고 긴 세션에서만 설정 파일을 사용하거나, 스크립트 맨 위에 `[ -f ~/.aider-away ] || exit 0`과 같은 확인 코드를 추가하세요. 자리를 비울 때 그 파일을 만들면 됩니다.

### 무료인가요?

네. Cline과 Aider는 오픈소스이며, Pocket Alert 무료 플랜은 기기 한 대당 하루 50개 메시지를 제공합니다.

[API 키 발급받기](/signup)를 하고, 스크립트를 넣은 뒤 에이전트가 작업이 끝났을 때 알려주도록 해 보세요.
