Signal does not offer bot accounts, so memcode connects through signal-cli, a companion tool that holds a Signal account as a linked device. You install it once, link it to a number, and memcode talks to it locally.

Step 1: Install signal-cli

brew install signal-cli

or install it from your package manager.

Step 2: Link a dedicated number

Use a separate number for the bot, not your main one: the linked device sees everything sent to that number. A spare SIM, a second line, or a prepaid number all work.

signal-cli link -n memcode

This prints a QR code. On the phone that owns the bot's number, open Signal and go to Settings → Linked Devices → Link New Device, then scan it.

Step 3: Start signal-cli in HTTP mode

signal-cli daemon --http

Leave this running; it is the bridge memcode talks to.

Step 4: Configure

memcode gateway setup

Choose signal and enter the bot's phone number. When prompted for allowed users, enter the phone numbers that may drive the agent.

Step 5: Run

memcode gateway

then message the bot's number from Signal. Each message runs as an agent job and the reply comes back in the chat.

Groups

Add the bot's number to a group like any other member. In a group it acts only when you @mention it or reply to one of its messages, so it does not run on ordinary chatter.

Voice notes and media

Voice notes sent to the bot are transcribed and treated as the task. Images and files are understood too; Signal caps media at about 8MB per message on its side.

Signal