Signal CLI

---

name: signal-cli description: Send Signal messages and look up Signal recipients via the local signal-cli installation on macOS. Use when the user asks to message someone on Signal, send a Signal text/attachment, list Signal contacts, or resolve a recipient by name/nickname/phone number.

---

signal-cli (Signal Messaging)

Use the local signal-cli binary.

Preconditions

signal-cli is installed and already linked/registered.

For safety: confirm recipient + final message text with the user before sending.

Quick patterns

Discover available accounts

signal-cli listAccounts

List contacts (JSON)

signal-cli -o json -u "+386..." listContacts

Find a contact by name/nickname/number

Prefer the bundled script (handles fuzzy-ish matching + multiple matches):

python3 scripts/find_contact.py --account "+386..." --query "Name"

Send a message

Prefer the bundled script (resolves contact names to numbers):

python3 scripts/send_message.py --account "+386..." --to "Name" --text "Heyo ..."

If --to is already a phone number in E.164 (e.g. +386...), it sends directly.

Safety checklist (always)

If resolving by name returns multiple matches, present options and ask the user which one.

If message contains sensitive info, ask explicitly before sending via Signal.

Default to --service-environment live (signal-cli default) and normal trust behavior.