에이전트 소식,
원하는 곳으로.

Gnista는 어느 코딩 에이전트가 작업 중인지, 응답을 기다리는지, 끝났는지 이미 알고 있어요. Webhook은 그걸 밖으로 전해요. Slack, Discord, Microsoft Teams의 메시지, Home Assistant나 홈의 빨간 램프, 내 로그의 한 줄. 각각 설정하는 방법과, Gnista 없이 하려면 무엇이 필요한지 정리했어요.

7일 무료로 써 보기계정·카드 불필요 · 이후 €19 한 번

업데이트

짧은 답

Gnista의 설정 ▸ 알림 ▸ Webhook에서 ‘추가’를 클릭하고, Slack, Discord, Microsoft Teams 또는 ‘Home Assistant 또는 기타’를 골라 URL을 붙여 넣거나, ‘단축어’를 골라 내 단축어 하나를 선택하세요. 그때부터 고른 변화가 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. 같은 메뉴에서 ‘테스트’를 고르세요. 샘플 하나가 나가거나 단축어가 한 번 실행되고, 결과가 행에 표시돼요. Webhook마다 스위치가 있어서, 지우지 않고 잠시 멈출 수 있어요.

Slack

Slack은 수신 Webhook(Incoming Webhook)으로 채널에 글을 올려요. api.slack.com/apps (새 탭에서 열림)에서 Slack 앱 설정을 열고(앱이 없으면 하나 만드세요), Incoming Webhooks를 켠 다음 Add New Webhook to Workspace를 클릭하고 채널을 고르세요. URL은 https://hooks.slack.com/services/로 시작해요. 변화 하나가 한 줄이 되고, 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과 같은 한 줄이 카드로 와요.

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이 깨어 있어야 해요.

단축어 앱에서 이렇게 하는 단축어를 만드세요.

  1. ‘입력에서 사전 가져오기’, 그다음 event에 대해 ‘사전 값 가져오기’.
  2. ‘조건문’으로 값이 needsYou이면 ‘홈 제어’나 장면으로 조명을 빨간색으로 켜요.
  3. ‘그렇지 않은 경우’에는 ‘홈 제어’로 그 조명을 꺼요.
  4. Gnista에서 ‘추가’ ▸ ‘단축어’를 클릭하고 그 단축어를 고르세요. ‘이벤트’를 ‘전체’로 두면 에이전트가 다음으로 넘어갈 때 조명이 다시 꺼져요.

Google Home

Google Home에는 Mac에서 조명을 바꿀 수 있는 수신 webhook도, 공개 웹 API도 없어요. 개발자용 Home APIs는 Android와 iPhone 앱을 위한 것이고, 자동화는 웹 요청으로 시작할 수 없어요.

되는 방법은 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은 변화마다 작은 객체 하나로, 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로 해서 한 번 실행해요.
  • 집중 모드, 잠긴 화면, 조용히 둔 세션, 폴더, 에이전트도 막지 않아요. 자동화는 보통 전부 받고 싶어 하니까요. 줄이고 싶다면 받는 쪽에서 거르세요.
  • 암호화하지 않은 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.

다른 가이드.