A hackable second brain for software developers.
Knowledge management, AI-powered writing, and deep code integration — all in one workspace.
Choose the installer for your platform. All binaries are unsigned — you may need to allow the app through your OS gatekeeper on first launch.
| Platform | Architecture | Download | Size |
|---|---|---|---|
| 🪟 Windows | ARM64 | citadel-1.2.2-arm64-portable.exe | 116 MB |
| 🪟 Windows | x64 | citadel-1.2.2-portable.exe | 227 MB |
| 🪟 Windows | x64 | citadel-1.2.2-x64-portable.exe | 110 MB |
| 🍎 macOS | Apple Silicon | citadel-1.2.2-arm64.dmg | 131 MB |
| 🍎 macOS | Universal | citadel-1.2.2-universal.dmg | 208 MB |
| 🍎 macOS | Intel | citadel-1.2.2-x64.dmg | 135 MB |
| 🐧 Linux | x86_64 (deb) | citadel-1.2.2-amd64.deb | 94 MB |
| 🐧 Linux | ARM64 (AppImage) | citadel-1.2.2-arm64.AppImage | 135 MB |
| 🐧 Linux | ARM64 (deb) | citadel-1.2.2-arm64.deb | 90 MB |
| 🐧 Linux | x86_64 (AppImage) | citadel-1.2.2-x86_64.AppImage | 135 MB |
Which file should I download?
| Platform | Recommended | Notes |
|---|---|---|
| Windows | portable.exe |
No installation required, just download and run |
| Windows | setup.exe |
NSIS based installer |
| macOS (Apple Silicon) | arm64.dmg |
For M1/M2/M3/M4 Macs |
| macOS (Intel) | x64.dmg |
For older Intel-based Macs |
| macOS (Universal) | universal.dmg |
Works on both Apple Silicon and Intel |
| Linux | .AppImage |
Portable, works on most distributions |
| Linux (Debian/Ubuntu) | .deb |
Native package manager integration |
This repository is the packaging and distribution shell for Citadel. It does not contain application source code — it consumes the pre-built citadel-payload.zip from the monorepo and wraps it with Electron Builder for each platform.
citadel (monorepo) → builds app code, publishes @citadel-app/app
↓ triggers
citadel-desktop (this repo) → packages into platform installers, publishes releases
- A new release in
citadel-app/citadeltriggers theBuild Desktop Appworkflow - The workflow downloads the latest
citadel-payload.zip(containing the pre-builtout/directory) - Electron Builder packages the payload into platform-specific installers across 3 OS runners
- All artifacts are uploaded to a draft GitHub Release for review
Production builds support auto-updates via electron-updater. The updater checks this repository's releases for new versions and downloads full binary replacements.
# Install dependencies
npm install --legacy-peer-deps
# Build for your platform
npm run build:win # Windows
npm run build:mac # macOS (universal)
npm run build:linux # LinuxNote: You need the
citadel-payload.zipextracted into./out/before building. See the monorepo for build instructions.
MIT © Citadel