Skip to content

Channels: Signal

Signal is a Tier 1 channel. Wayland talks to Signal through signal-cli, a local command-line client registered to a phone number. You register or link a number, point Wayland at the signal-cli binary, and messages flow through it.

Before you start (prerequisites and accounts)

Section titled “Before you start (prerequisites and accounts)”
  • A phone number you can register with Signal, or an existing Signal account to link as a second device.
  • signal-cli available on the same machine as Wayland.
  • The Wayland desktop app running with a model provider connected.

Create the credentials (on the provider side)

Section titled “Create the credentials (on the provider side)”
  1. Install signal-cli and register the phone number, or link it as a device to an existing Signal account.
  2. Complete any verification step Signal requires.
  3. Note the phone number in full international form and the path to the signal-cli binary.

Connect it in Wayland (Settings -> Channels -> Signal)

Section titled “Connect it in Wayland (Settings -> Channels -> Signal)”
  1. Open Settings -> Channels and choose Signal.
  2. Enter the Phone number.
  3. Enter the signal-cli path if the binary is not on the default path.
  4. Save.

Verify (status goes from idle to connected, send a test message)

Section titled “Verify (status goes from idle to connected, send a test message)”

After saving, the status moves from idle to connected. Send a Signal message to the registered number and confirm a reply.

Set the assistant and default model on the Signal page. Inbound Signal messages route to that assistant.

If the channel does not connect, confirm the number is registered and the signal-cli path is correct. See Channel Connection Issues.