AsamK /signal-cli
signal-cli provides an unofficial commandline, JSON-RPC and dbus interface for the Signal messenger.
★ 5,048⑂ 477👁 62⑃ 289● 1,459▤ 120
+1
Daily
5,048
stars
477
forks
62
watchers
289
prs
1,459
issues
120
releases
README
signal-cli
signal-cli is a commandline interface for the Signal messenger.
It supports registering, verifying, sending and receiving messages.
signal-cli uses a patched libsignal-service-java,
extracted from the Signal-Android source code.
For registering you need a phone number where you can receive SMS or incoming calls.
Existing accounts without a phone number can be linked from a compatible Signal mobile app.
signal-cli is primarily intended to be used on servers to notify admins of important events.
For this use-case, it has a daemon mode with JSON-RPC interface (man page)
and D-BUS interface (man page).
For the JSON-RPC interface there's also a simple example client, written in Rust.
signal-cli needs to be kept up-to-date to keep up with Signal-Server changes.
The official Signal clients expire after three months and then the Signal-Server can make incompatible changes.
So signal-cli releases older than three months may not work correctly.
Installation
You can build signal-cli yourself or use
the provided binary files, which should work on Linux, macOS and
Windows. There's also a docker image and some Linux packages provided by the community.
System requirements:
- at least Java Runtime Environment (JRE) 25
- native library: libsignal-client
The native libs are bundled for x86_64 Linux (with recent enough glibc), Windows and MacOS. For other
systems/architectures
see: Provide native lib for libsignal
Install system-wide on Linux [ JVM build ]
See latest version.
sh
VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/AsamK/signal-cli/releases/latest | sed -e 's/^.\/v//')
curl -L -O https://github.com/AsamK/signal-cli/releases/download/v"${VERSION}"/signal-cli-"${VERSION}".tar.gz
sudo tar xf signal-cli-"${VERSION}".tar.gz -C /opt
sudo ln -sf /opt/signal-cli-"${VERSION}"/bin/signal-cli /usr/local/bin/
Install system-wide on Linux [ GraalVM native build ]
sh
VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/AsamK/signal-cli/releases/latest | sed -e 's/^.\/v//')
curl -L -O https://github.com/AsamK/signal-cli/releases/download/v"${VERSION}"/signal-cli-"${VERSION}"-Linux-native.tar.gz
sudo tar xf signal-cli-"${VERSION}"-Linux-native.tar.gz -C /opt
sudo ln -sf /opt/signal-cli /usr/local/bin/
You can find further instructions on the Wiki:
- Quickstart
Usage
For a complete usage overview please read
the man page and
the wiki.
For a numbered account, ACCOUNT is your phone number in international format and must include the country calling code. Hence it
should start with a "+" sign. (See Wikipedia for a list
of all country codes.)
For a linked account without a phone number, use its ACI (Account ID) instead.
See the wiki for further documentation.
Link to an existing account
If you have an existing Signal account, with or without a phone number,
you can link signal-cli to it with:
signal-cli link
Register a number (with SMS verification)
Alternatively, if you don'Top issues
#2099Error "signal-cli: CPU ISA level is lower than required" after Debian upgrade from 12 to 1316 comments · 2026-08-07#1585signal-cli in jsonRpc mode started consuming 100% CPU13 comments · 2024-09-11#2075Android apps failed receiving messages with --text-style12 comments · 2026-06-29#1873Feature request - Easy text formatting for *BOLD* , _ITALIC_ , ```MONOSPACE``` , ~STRIKETHROUGH~ etc10 comments · 2025-11-11#1592[Feature Request] Add stories compatibility10 comments · 2024-09-24#2121Performance issue since v0.14.8, maybe?9 comments · 2026-09-16#2039Does signal-cli support short captcha?9 comments · 2026-05-05#2012signal-cli fills up %temp% with 20MB libsignal<number>\signal_jni_amd64.dll on every run (Windows)9 comments · 2026-04-10
Discussions
#2165v0.14.100 comments · 2026-11-07#2158Windows Smart App Control blocks bundled signal_jni_amd64.dll in signal-cli 0.14.91 comments · 2026-10-30#2139v0.14.90 comments · 2026-10-07#2137Config file is in use by another instance, waiting…1 comments · 2026-10-06#2130remoteDelete vs. adminDelete with jsonrpc2 comments · 2026-09-27#2115v0.14.82 comments · 2026-09-10#2103How to download attachments to a specific message?1 comments · 2026-08-13#2095v0.14.70 comments · 2026-08-01
Latest release
v0.14.10 v0.14.10 2026-11-07What's Changed Fix race between stopping and starting the receive thread by @iddo in https://github.com/AsamK/signal-cli/pull/2142 Download attachments from synced message edits by @Copilot in https://github.com/AsamK/signal-cli/pull/2143 Accept group invitations addressed to the PNI by @wakamex in https://github.com/AsamK/signal-cli/pull/2146 Deliver the envelope in hand to the last receive handler before it is removed by @wappensc-developer in https://github.com/AsamK/signal-cli/pull/2153 Add native reflection metadata for FinishLinkCommand by @garsteaa in https://github.com/AsamK/