Files
Gabriel Vidal 130e7443b8 fix(ha): install.sh finds the HA config after the repo left the homelab
The four-levels-up guess resolved to ~/ once this repo moved to ~/projects;
fall back to the homelab checkout (HOMELAB_DIR, default ~/homelab).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-14 03:44:54 +02:00
..

ai-agent integrations

Out-of-container companions that connect the ai-agent notification hub to the outside world. The backend itself only knows about generic webhooks (Settings → Webhooks, GET/PUT /api/webhooks); each integration here is the receiving end of one of those webhooks.

  • home-assistant/ — a Home Assistant custom component (ai_agent) that renders the hub's notify / ask events as mobile notifications (asks get their own channel + ". .. .._" vibration and their tapped answer is POSTed back to the backend).

How notifications flow

notify-done skill (notify.sh / ask.sh)
        │  POST /api/notify | /api/ask
        ▼
ai-agent backend  ──record──▶  /data/notifications.json   (source of truth)
        │  POST {event: notify|ask, …}
        ▼
configured webhooks (e.g. HA /api/webhook/ai_agent)
        │  notify.mobile_app_pixel_9
        ▼
      phone  ──tap──▶  HA integration ──POST /api/ask/{id}/answer──▶ backend