Signal brings your agent to your phone

Text your agent on Signal. Your agent has a number of its own, linked from its phone, and it answers you and no one else.

lnk agent start               # your agent, unless it runs already
lnk agent connect signal      # its number and yours, then scan the QR code

Connect it

Give your agent a number of its own, such as a second or prepaid SIM. connect asks for the agent's number and yours, then shows a QR code to scan from the agent's phone (Settings > Linked Devices > Link New Device). The first time, Link installs signal-cli for you.

lnk agent connect signal

Without prompts

From a script, give both numbers in their variables, and scan the QR code as before.

LNK_SIGNAL_NUMBER=+15557654321 LNK_SIGNAL_OWNER=+15551234567 lnk agent connect signal

Photos and documents

For a harness that takes images and documents (Link Harness), the photos and documents a message holds go to the agent with its text: PNG, JPEG, GIF or WebP images and PDF or text documents, up to 10 MiB each and 8 a message, read from what signal-cli kept of them in the account's folder.

What it leaves out

Anything else, a voice note or a video, is named to the agent as left out; sent alone, it's answered with what the agent reads. For another harness, a message holding only them is answered "I can read text only, for now."

Disconnect

disconnect forgets Signal's tokens and restarts your agent if it runs. To finish, unlink it on the agent's phone (Settings > Linked Devices).

lnk agent disconnect signal

When it doesn't work: Troubleshooting.

Docs

  • Decisions: How the Signal plugin connects an agent, through signal-cli
  • Troubleshooting: What to do when your agent's Signal number doesn't link or doesn't answer (Signal)