labor.fun: Skill for Claude Code

Add Signal Channel

This skill adds Signal support to Breadbrich Engels, then walks through interactive setup.

Signal has no official bot API. The channel talks to a locally-running signal-cli daemon over its JSON-RPC interface (newline-delimited JSON over a TCP socket). The same socket carries both directions — outbound send requests and inbound receive notifications — so no public URL, webhook, or extra npm dependency is needed (Node's built-in net module does the work).

Phase 1: Pre-flight

Check if already applied

Check if src/channels/signal.ts exists. If it does, the code is in place — skip to Phase 2 (Setup).

If it does not exist, the channel code needs to be merged first. It lives on the framework's main (or a skill/signal branch). Pull it in, then validate:

npm install
npm run build
npx vitest run src/channels/signal.test.ts

All tests must pass and the build must be clean before continuing.

Phase 2: Setup

Install signal-cli on the host

signal-cli is a separate binary that owns the Signal account and speaks the JSON-RPC the channel connects to.

# macOS
brew install signal-cli

# Debian/Ubuntu (or download a release from github.com/AsamK/signal-cli/releases)
#   signal-cli needs a JRE 21+ on the PATH

Verify: signal-cli --version

Register or link a Signal number

SIGNAL_ACCOUNT is the Signal phone number (E.164, e.g. +15551234567) that signal-cli controls. Two options — ask the user which they want:

Option A — link to an existing phone (recommended, fastest):

signal-cli link -n "breadbrich"
# Prints a tsdevice:/ URI. Render it as a QR code (e.g. paste into
# `qrencode -t ansiutf8 "<uri>"`) and scan it from the phone:
#   Signal app → Settings → Linked Devices → Link New Device

The account number is the phone's own number.

Option B — register a dedicated number (needs a number that can receive an SMS/voice code, e.g. a Google Voice or Twilio number):