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