Nyx Homeassistant Node — Development skill for Claude Code

NyxID Node — Home Assistant Add-on

Run a [NyxID](https://github.com/ChronoAIProject/NyxID) credential node agent on Home Assistant OS. Securely reverse-proxy your Home Assistant instance and other LAN services through NyxID — credentials never leave your local network.

Quick Start — Give This to Your AI Assistant

Copy this one line into Claude Code, Codex, Cursor, or any AI coding assistant:

Install the NyxID Node add-on on my Home Assistant. Follow the guide at https://github.com/ChronoAIProject/nyx-homeassistant-node/blob/main/SETUP_GUIDE.md

The AI will walk you through the setup step by step.

Documentation

• SETUP_GUIDE.md — user-facing install + config walkthrough
• docs/ARCHITECTURE_NOTES.md — deep reference: HA auth model, NyxID service lifecycle, filed upstream issues, and the full design rationale. Read this before making architectural changes.
• DEVELOPMENT.md — chronological build history up to v1.0.0

How It Works

External Client → NyxID Server → WebSocket → This Add-on → Local Services
                                (outbound)    (credential    (HA, NAS, etc.)
                                              injection)

1. The add-on connects to your NyxID server via outbound WebSocket (no inbound ports needed)
2. When a proxy request arrives, the node agent injects the locally-stored credentials
3. The request is forwarded to the target service on your LAN
4. Credentials never leave your network — NyxID only sees the request metadata

Installation

1. In Home Assistant, go to Settings → Add-ons → Add-on Store
2. Click ⋮ → Repositories and add:

   https://github.com/ChronoAIProject/nyx-homeassistant-node

3. Find NyxID Node in the store and click Install

Setup

Step 1: Create the HA service (on your machine, one-time)

nyxid service add --custom \
  --label "Home Assistant" \
  --endpoint-url "http://s