Local daemon

Citadel Agent: the local daemon behind Citadel apps

The Citadel Agent (citadeld) is a local daemon that manages the lifecycle of Citadel Protocol connections and exposes them to local applications over a lightweight IPC interface, so several apps can share the protocol without embedding the SDK.

Citadel Agent at a glance

What it is
The local daemon (citadeld) that manages Citadel Protocol connections, so several apps on one machine can use them without embedding the SDK.
Made by
Avarok Cybersecurity, founded by Thomas Braun, founder of Avarok (thomaspbraun.com)
Licence
MIT
Runs on
macOS, Linux, Windows
Website
GitHub releases
Source
github.com/Avarok-Cybersecurity/citadel-agent

What does the Citadel Agent do?

The Citadel Agent (citadeld) is a local daemon that manages the lifecycle of secure connections for applications on the same machine. It sits between those apps (command-line, desktop or web) and the Citadel Protocol SDK, and exposes a lightweight interface over local sockets and WebSocket. Apps send it requests; the agent holds the encrypted tunnels to servers and the peer-to-peer channels to other people.

Because one agent multiplexes every session on the machine, several local apps can use the Citadel Protocol at once without each embedding the SDK or managing connection state. Citadel Workspace runs on it: the web app connects to the agent over localhost only.

Download the Citadel Agent

These links always fetch the newest release from GitHub.

macOS
Citadel Agent for macOS (.dmg), or the archives for Apple silicon and Intel Macs
Windows
Citadel Agent for Windows (.msi installer), or the .zip archive
Linux
Citadel Agent for Debian and Ubuntu (.deb), the AppImage, or the .tar.gz archive
All releases
Citadel Agent release notes and every file on GitHub

How do I verify a download?

Each release is built and attested by GitHub Actions. With the GitHub CLI installed, check that a file is the one the release workflow built:

gh attestation verify Citadel-Agent.dmg --repo Avarok-Cybersecurity/citadel-workspace

Every file is also published beside a .sha256 checksum. Compute the file's SHA-256 and compare it with that file on the release page:

macOS
shasum -a 256 Citadel-Agent.dmg
Linux
sha256sum citadel-agent-linux-x64.deb
Windows (PowerShell)
Get-FileHash -Algorithm SHA256 Citadel-Agent-x64.msi

Citadel Agent: The local daemon (citadeld) that manages Citadel Protocol connections, so several apps on one machine can use them without embedding the SDK.

Choose your Citadel Agent download

More from Avarok