エージェントの動きを、
好きな場所へ。

Gnistaは、どのコーディングエージェントが作業中で、どれが対応待ちで、どれが完了したかを、もう知っています。Webhookはそれを外へ渡します。Slack、Discord、Microsoft Teamsへのメッセージ、Home Assistantやホームの赤いランプ、自分のログの1行。それぞれの設定方法と、Gnistaを使わない場合に必要なことを紹介します。

7日間無料で試すアカウント・カード不要 · その後€19の買い切り

更新:

手短に言うと

Gnistaの設定 ▸ 通知 ▸ Webhookで「追加」をクリックし、Slack、Discord、Microsoft Teams、または「Home Assistantなど」を選んでURLを貼り付けるか、「ショートカット」を選んで自分のショートカットを1つ選びます。あとは、選んだ変化が、Gnistaが接続するすべてのエージェントから届きます。Claude Code、Codex、Gemini CLI、OpenCodeなど、Mac上のものもSSH越しのものも。

Gnistaを使う

  1. Gnistaをダウンロードして開き、使うエージェントにチェックを入れます。
  2. 設定 ▸ 通知を開き、「試験的」のタグがついたWebhookを見つけます。
  3. 「追加」をクリックして選びます。チャットのメッセージならSlack、Discord、Microsoft Teams。Home Assistantや自作のスクリプト向けの小さなJSONであるGnista JSONなら「Home Assistantなど」。そのJSONで自分のショートカットを実行するなら「ショートカット」です。
  4. URLを貼り付けるか、ショートカットを選びます。Gnista JSONでは「シークレット」も設定でき、Bearerトークンとして送られます。
  5. 行の⋯メニューで「イベント」を選びます。「すべて」「対応待ちのみ」「対応待ちと完了したターン」のどれかです。チャットはチャンネルがあふれないよう「対応待ちのみ」から、Gnista JSONとショートカットは「すべて」から始まります。
  6. 同じメニューで「テスト」を選びます。サンプルが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で、次のようなショートカットを作ります。

  1. 「入力から辞書を取得」のあと、eventについて「辞書の値を取得」。
  2. 「if文」で値がneedsYouなら、「ホームをコントロール」かシーンで、ライトを赤で点けます。
  3. 「その他の場合」は、「ホームをコントロール」でそのライトを消します。
  4. 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へ。

ほかのガイド。