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
JavaGPL-3.0Created 2015-05-11
Download: v0.14.10v0.14.10 ↓0.14.102026-11-07
+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

Discussions

Latest release

v0.14.10 v0.14.10 2026-11-07
What'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/

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON