| 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.
