エージェントの動きを、
好きな場所へ。
Gnistaは、どのコーディングエージェントが作業中で、どれが対応待ちで、どれが完了したかを、もう知っています。Webhookはそれを外へ渡します。Slack、Discord、Microsoft Teamsへのメッセージ、Home Assistantやホームの赤いランプ、自分のログの1行。それぞれの設定方法と、Gnistaを使わない場合に必要なことを紹介します。
更新:
手短に言うと
Gnistaの設定 ▸ 通知 ▸ Webhookで「追加」をクリックし、Slack、Discord、Microsoft Teams、または「Home Assistantなど」を選んでURLを貼り付けるか、「ショートカット」を選んで自分のショートカットを1つ選びます。あとは、選んだ変化が、Gnistaが接続するすべてのエージェントから届きます。Claude Code、Codex、Gemini CLI、OpenCodeなど、Mac上のものもSSH越しのものも。
Gnistaを使う
- Gnistaをダウンロードして開き、使うエージェントにチェックを入れます。
- 設定 ▸ 通知を開き、「試験的」のタグがついたWebhookを見つけます。
- 「追加」をクリックして選びます。チャットのメッセージならSlack、Discord、Microsoft Teams。Home Assistantや自作のスクリプト向けの小さなJSONであるGnista JSONなら「Home Assistantなど」。そのJSONで自分のショートカットを実行するなら「ショートカット」です。
- URLを貼り付けるか、ショートカットを選びます。Gnista JSONでは「シークレット」も設定でき、Bearerトークンとして送られます。
- 行の⋯メニューで「イベント」を選びます。「すべて」「対応待ちのみ」「対応待ちと完了したターン」のどれかです。チャットはチャンネルがあふれないよう「対応待ちのみ」から、Gnista JSONとショートカットは「すべて」から始まります。
- 同じメニューで「テスト」を選びます。サンプルが1件送られるか、ショートカットが1回実行され、結果が行に表示されます。Webhookごとにスイッチがあるので、削除せずに一時停止できます。
Slack
Slackは、Incoming Webhookでチャンネルに投稿します。api.slack.com/apps (新しいタブで開きます)でSlackアプリの設定を開き(なければアプリを作成)、Incoming Webhooksをオンにして、Add New Webhook to Workspaceをクリックし、チャンネルを選びます。URLはhttps://hooks.slack.com/services/で始まります。変化は1件ずつ1行になり、Macの通知と同じ言い回しで、アプリの言語で届きます。エージェント、起きたこと、プロジェクト、そして尋ねていること。
Discord
Discordで、チャンネルの「チャンネルの編集」▸「連携サービス」▸「ウェブフック」を開き、「新しいウェブフック」をクリックしてから「ウェブフックURLをコピー」を押します。メッセージはSlackと同じ内容で、誰にもメンションしません。@everyone、@hereなどのメンションはオフになっています。
Microsoft Teams
Teamsは「ワークフロー」アプリでWebhookを受け取ります。以前のOffice 365コネクタは廃止が進んでいます。チャネルの⋯ ▸「ワークフロー」を開き、テンプレート「Send webhook alerts to a channel」を選び、チームとチャネルを選んで「保存」をクリックします。表示されたWebhook URLをコピーし、GnistaでMicrosoft Teamsとして追加します。変化はそれぞれ、Slackと同じ1行のカードとして届きます。
MattermostとRocket.ChatはSlackの形式を受け付けます。受信WebhookのURLをSlackとして追加してください。
Home Assistant
Webhookトリガー (新しいタブで開きます)を使ったオートメーションを作ります。POSTを許可し、推測しにくいIDにします。Gnistaで「Home Assistantなど」のWebhookを追加し、http://homeassistant.local:8123/api/webhook/のあとにそのIDを続けて貼り付けます。IDがシークレットの役目を果たすので、Gnistaの「シークレット」は空のままにします。
このオートメーションは、エージェントが対応待ちの間ランプを赤くし、次に進んだら消します。
alias: Agent needs me
triggers:
- trigger: webhook
webhook_id: gnista-pick-something-long
allowed_methods: [POST]
local_only: true
actions:
- choose:
- conditions: "{{ trigger.json.event == 'needsYou' }}"
sequence:
- action: light.turn_on
target: { entity_id: light.desk }
data: { color_name: red }
- conditions: "{{ trigger.json.event in ['working', 'done', 'idle', 'ended'] }}"
sequence:
- action: light.turn_off
target: { entity_id: light.desk }複数のエージェントが同時に動いているときは、最後の変化が優先されます。「どれかのセッションが対応待ち」にしたいなら、ヘルパーで数を数えます。
Appleのホーム
Macでは、GnistaはHomeKitを直接操作できません。Appleはホームの操作をiPhoneとiPad向けのアプリに限っているからです。ショートカットなら操作できるので、GnistaはGnista JSONを入力としてショートカットを実行します。実行されるのはMac上なので、Macがスリープしていないことが必要です。
ショートカットAppで、次のようなショートカットを作ります。
- 「入力から辞書を取得」のあと、
eventについて「辞書の値を取得」。 - 「if文」で値が
needsYouなら、「ホームをコントロール」かシーンで、ライトを赤で点けます。 - 「その他の場合」は、「ホームをコントロール」でそのライトを消します。
- Gnistaで「追加」▸「ショートカット」をクリックし、そのショートカットを選びます。「イベント」は「すべて」のままにすると、エージェントが次に進んだときにライトが消えます。
Google Home
Google Homeには、Macからライトを切り替えられる受信Webhookも公開Web APIもありません。開発者向けのHome APIsはAndroidとiPhoneのアプリ用で、オートメーションをWebリクエストで始めることもできません。
使える方法はHome Assistant (新しいタブで開きます)です。Matter、Philips Hue、NestなどGoogle Homeにあるライトのほとんどは、Home Assistantにも追加でき、Matterデバイスは両方で同時に使えます。そうすれば、上のオートメーションがそのまま動きます。
サーバーなしなら、IFTTTのWebhooks (新しいタブで開きます)のトリガーReceive a web request with a JSON payloadがGnista JSONを受け取り、Philips Hue、LIFX、GoveeなどのIFTTTサービスがライトの色を変えられます。トリガーのURL(https://maker.ifttt.com/trigger/にイベント名とキーを続けたもの)を、Gnistaで「Home Assistantなど」として追加し、「イベント」を「対応待ちのみ」にします。これでアプレットは、エージェントがあなたを必要とするときだけ動きます。Webhooksのトリガーには有料プランのIFTTT Proが必要です。
自作のスクリプト
Gnista JSONは、変化ごとに1つの小さなオブジェクトで、POSTで送られます。コマンドの実行を求めるCodexのセッションなら、こうなります。
{
"agent": { "id": "codex", "name": "Codex" },
"at": "2026-10-28T14:03:12Z",
"event": "needsYou",
"folder": "/Users/me/Git/shop",
"machine": null,
"message": "Codex wants to run `npm run build`",
"previous": "working",
"project": "shop",
"session": "019a…",
"version": 1
}eventはworking、needsYou、done、idle、endedのどれかで、previousは直前の状態です。キーと値はスクリプトのために英語で固定されていて、スクリプトが動かなくなる変更があればversionが上がります。messageは人が読むための文で、アプリの言語で書かれるので、照合には使わないでください。代わりにevent、agent.id、project、machineで絞り込みます。シークレットを設定すると、リクエストにAuthorization: Bearerとシークレットがつきます。
Gnistaを使わない
- 各エージェント自身のフックからURLへ送れます。Claude Codeの
NotificationフックとStopフック、Gemini CLIやQwen Codeのフック、Codexのnotifyのプログラムで、それぞれcurlを実行します。動きますが、エージェントごとに書いて保守するのは自分で、送られるデータの形もエージェントごとに違います。 - フックがなければ、エージェントのターミナルか、Macでのエージェント自身の通知で知ることになります。
知っておきたいこと
- Webhookは「試験的」の機能です。
- 送るだけです。リクエストに応答するには、ノッチかエージェントのターミナルを使います。
- ショートカットはGnista JSONを入力としてMac上で実行され、30秒で停止されます。「テスト」は
eventをtestにして1回実行します。 - 集中モード、画面ロック、通知しないことにしたセッション、フォルダ、エージェントでも止まりません。オートメーションでは、たいていすべてが必要だからです。減らしたいときは受け取る側で絞り込みます。
- 暗号化しない
http://は、homeassistant.localやそのネットワーク内のIPアドレスなど、ローカルネットワークにだけ使えます。それ以外はhttps://が必要です。初回は、Gnistaがローカルネットワーク上のデバイスを探すことを許可するか、macOSに聞かれることがあります。 - URLとシークレットはキーチェーンに保管します。Webhookはそれぞれ別々に、10秒のタイムアウトで再試行なしで送るので、遅いものがほかを待たせることはありません。
- Macから離れている間にスマートフォンで受け取るなら、設定 ▸ 通知 ▸「スマートフォンに送信」で、Bark、ntfy、Pushover、Telegramへ。Macそのものでは、Claude Codeの通知とCodexの通知へ。
- 7日間無料、その後は€19の買い切り。詳しくはClaude Code、Codex、Gemini CLI、OpenCodeへ。
ほかのガイド。
Claude Codeの通知を、
Macで。Claude Codeが終わったか、対応待ちかが、Macのどこにいてもわかります。
Codexの通知を、
Macで。Codexが終わったか、コマンドを実行したがっているかが、ターミナルを見張らなくてもわかります。
Claude Codeのリクエストを、
切り替えずに承認。コマンドや編集を、ノッチから許可または拒否。そのまま元の作業へ。
Claude CodeとCodexの上限を、
ひと目で。Claude CodeとCodexの5時間ごとと週ごとの上限を、セッションの下に。
Xcodeのエージェントを、
ノッチの中に。XcodeのClaude、Codex、Antigravityの出番が、Xcodeを前面に出しておかなくてもわかる。
サーバのエージェントに、
Macから応答。サーバやほかのMac上のClaude Code、Codexなどの出番がわかり、Macから応答できます。
コンテナのエージェントも、
すぐ手の届く所に。devcontainerやKubernetesのポッドの中のClaude CodeやCodexも、リクエストはノッチに届きます。