FamReynaBrain/projects/colanode-hermes-bridge/README.md

Colanode Hermes Bridge

Standalone Node 22 TypeScript service that listens to Colanode synchronizer events and replies through Hermes only when a new Colanode message node explicitly mentions the bot user.

Safety

• Reads secrets from $HOME/.hermes/secrets/colanode-family-bot.env.
• Requires that secret file to be mode 0600.
• Uses Colanode client HTTP/WebSocket APIs only.
• Does not write to Postgres, Hermes config, Caddy, Colanode deployment files, or Colanode data outside the documented mutation API.
• Tests never send Colanode replies.

Secret File

Expected variables:

COLANODE_TOKEN=...
# Optional fallback only if a stored token is unavailable:
COLANODE_EMAIL=bot@example.com
COLANODE_PASSWORD=...

Optional overrides are shown in .env.example.

Commands

npm install
npm run build
npm test

Run foreground service after build:

npm start