ブログに戻る

Cline・Aider のプッシュ通知: 自分の番がいつ来るか把握する

Cline・Aider のプッシュ通知: 自分の番がいつ来るか把握する

Cline と Aider は、バックグラウンドで動かしたままにされることが多い 2 つのオープンソースのコーディングエージェントです。どちらも、確認すべきことがあるときにコマンドを実行できます。ただし、それだけではスマホに通知は届きません。数行の設定を変えるだけで対応できます。

  • Cline はタスクが完了したときにフックスクリプトを実行します。また MCP に対応しているため、自分で書いた内容をプッシュ通知として送ることもできます。
  • Aider はあなたの入力を待っているとき、つまり応答の後や、はい/いいえの確認の前に通知コマンドを実行します。

どちらも Pocket Alert 経由で送信するため、他の処理からのアラートと同じアプリに、同じ履歴で届きます。

必要なもの

  • Pocket Alert のアカウント、API キー、そして iPhone または Android のスマホ用アプリ。無料プランで十分です。
  • curl。Cline のフックには jq も必要です。

API キーはファイルに保存してください。macOS の Dock から起動したエディタはシェルのプロファイルを読み込まないため、ファイルにしておけば両方のエージェントから確実に参照できます。

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 を使ってください。

スクリプトは標準入力で JSON オブジェクトを受け取ります。TaskComplete で注目すべきフィールドは、Cline の最終回答である taskComplete.taskMetadata.result と、開いているフォルダーの workspaceRoots です。initialTask というフィールドもありますが、現在の拡張機能では空の値が送られます。

#!/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":""}'
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 サーバー経由でプッシュ通知を送ることもできます。Cline の MCP 設定ファイル ~/.cline/data/settings/cline_mcp_settings.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 に指示を追加します。

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 が作業しているリポジトリです。

#!/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 の 2.0 以降をインストールして認証済みであれば、スクリプトは不要です。下の設定にコマンドを直接書けます。

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 に 2 行追加します。

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

一度だけ使う場合は次のとおりです。

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

通知のタイミング

Aider は、モデルの応答ごとに 1 回通知を送ります。その後、初めてあなたの入力を待つタイミングです。通常は、編集が終わった後の通常のプロンプトになります。最初に必要になるのが「ファイルをチャットに追加しますか?」や「シェルコマンドを実行しますか?」といった確認である場合は、その時点で通知が届きます。これが「承認待ち」のケースです。同じやり取りの中で続く確認では、再度プッシュ通知は送られません。

Aider は MCP に対応していないため、通知コマンドを使うことになります。それで十分でもあります。Aider は応答のたびにあなたを待つので、そのタイミングで知らせてもらえれば目的は果たせます。

スマホに届く内容

エージェントタイトル本文
ClineCline finished · apiCline の結果の最初の 300 文字
MCP 経由の Clineエージェントが書いた内容エージェントが選んで送った要約
AiderAider is waiting · apiYour turn: reply or confirm in the terminal.

メッセージの優先度は、初期設定では通常です。iPhone の集中モードでも届けたい場合は、JSON に "level": "high" を追加してください。逆に静かに届けたい場合は "low" を指定し、戻ってきたときに履歴を確認するとよいでしょう。

届かない場合

  • スクリプトを手動で実行してください。 Cline の場合は echo '{}' | ~/Documents/Cline/Hooks/TaskComplete、Aider の場合は ~/.config/pocketalert/aider-notify.sh です。通知が届かない場合は、API キーかネットワークに問題があります。>/dev/null 2>&1 を削除すると、curl の応答を確認できます。
  • ファイル名を確認してください。 Cline はファイル名でフックを判別します。TaskComplete と完全に一致させ、実行可能にして、.sh は付けないでください。
  • Aider の設定キーを確認してください。 Aider のサンプル設定どおり、ハイフン付きの notifications-command を使います。

FAQ

両方のエージェントを設定する必要はありますか?

いいえ。2 つのセクションは独立しているので、使っている方だけ設定してください。

Cline や Aider は私の API キーを見られますか?

フックと通知コマンドは、キーをファイルから読み込みます。会話の一部にはなりません。MCP の設定には、Cline がサーバーに接続するためにキーが含まれます。ただし、それがモデルに送られることはありません。

作業中に Aider から通知が連続で届きすぎませんか?

通知は応答ごとに 1 回です。デスクに向かっているときに多すぎると感じたら、--notifications を付けずに Aider を起動するか、長いセッションのときだけ設定ファイルを使ってください。あるいは、スクリプトの先頭に [ -f ~/.aider-away ] || exit 0 のようなチェックを加え、席を離れるときにそのファイルを作成する方法もあります。

料金はかかりますか?

かかりません。Cline と Aider はオープンソースで、Pocket Alert の無料プランでは 1 台のデバイスに 1 日 50 件まで送信できます。

API キーを取得し、スクリプトを配置して、エージェントからの呼び出しを受け取りましょう。

この記事をシェア