connectd home assistant integration

monitor your connectd daemon from home assistant.

installation

HACS (recommended)

1. open HACS in home assistant
2. click the three dots menu → custom repositories
3. add https://github.com/sudoxnym/connectd with category "integration"
4. search for "connectd" and install
5. restart home assistant
6. go to settings → devices & services → add integration → connectd

manual

1. copy custom_components/connectd to your HA config/custom_components/ directory
2. restart home assistant
3. go to settings → devices & services → add integration → connectd

configuration

enter the host and port of your connectd daemon:

• host: IP or hostname where connectd is running (e.g., 192.168.1.8)
• port: API port (default: 8099)

sensors

the integration creates these sensors:

stats

• sensor.connectd_total_humans - total discovered humans
• sensor.connectd_high_score_humans - humans with high values alignment
• sensor.connectd_total_matches - total matches found
• sensor.connectd_total_intros - total intro drafts
• sensor.connectd_sent_intros - intros successfully sent
• sensor.connectd_active_builders - active builder count
• sensor.connectd_lost_builders - lost builder count
• sensor.connectd_recovering_builders - recovering builder count
• sensor.connectd_lost_outreach_sent - lost builder outreach count

state

• sensor.connectd_intros_today - intros sent today
• sensor.connectd_lost_intros_today - lost builder intros today
• sensor.connectd_status - daemon status (running/dry_run/stopped)

per-platform

• sensor.connectd_github_humans
• sensor.connectd_mastodon_humans
• sensor.connectd_reddit_humans
• sensor.connectd_lemmy_humans
• sensor.connectd_discord_humans
• sensor.connectd_lobsters_humans

example dashboard card

type: entities
title: connectd
entities:
  - entity: sensor.connectd_status
  - entity: sensor.connectd_total_humans
  - entity: sensor.connectd_intros_today
  - entity: sensor.connectd_lost_intros_today
  - entity: sensor.connectd_active_builders
  - entity: sensor.connectd_lost_builders

automations

example: notify when an intro is sent:

automation:
  - alias: "connectd intro notification"
    trigger:
      - platform: state
        entity_id: sensor.connectd_intros_today
    condition:
      - condition: template
        value_template: "{{ trigger.to_state.state | int > trigger.from_state.state | int }}"
    action:
      - service: notify.mobile_app
        data:
          title: "connectd"
          message: "sent intro #{{ states('sensor.connectd_intros_today') }} today"