Install
Download Cordy Desktop, get past the SmartScreen or Gatekeeper warning, install on Linux, and update by hand.
Platform status
| Platform | Latest public build | Package |
|---|---|---|
| Windows x64 | 0.6.0 | NSIS installer (.exe) |
| macOS, Apple Silicon | 0.5.3 | .dmg or .zip |
| Linux x64 and arm64 | 0.5.3 | .AppImage or .deb |
- 0.5.4, 0.5.5, and 0.6.0 were published for Windows only. macOS and Linux users stay on 0.5.3, which does not have the features added since, such as block-editor notes.
- There is no Windows-on-ARM build and no Intel Mac build.
- The Windows installer is not code-signed. The macOS build is not notarized.
- Cordy Desktop is proprietary from 0.5.4 on. 0.5.3 and earlier were released under the MIT license.
A source tag is not a release: only builds attached to a published release in the public releases repository are available to download. Cordy Desktop is not distributed through any app store.
Get the build
Cordy Desktopv0.6.0
Released 2026-10-22Release notes
| Platform | Architecture | File | Size | SHA-256 |
|---|---|---|---|---|
| Windows | x64 | cordy-desktop-0.6.0-win-x64.exe | 123.4 MB | ca2173e23b13 |
Full checksums are in SHASUMS256.txt on the release page.
0.6.0 is available for Windows x64 only. For macOS (Apple Silicon) and Linux (x64/arm64), use Cordy Desktop 0.5.3. There is no Windows-on-ARM build. The Windows installer is not code-signed, so Windows SmartScreen warns you on first run — see the install guide.
Public builds come only from the public releases repository. Each release page, such as desktop-v0.6.0 or desktop-v0.5.3, lists its files and a SHASUMS256.txt.
Verify the download
Before you run a build, compare its SHA-256 with the SHASUMS256.txt from the same release. The verification guide has the command for each platform, including gh release verify for the build attestation.
A matching checksum proves the file is intact and is the one that was published. It does not prove the file is safe.
Windows
Requires Windows x64. For the full walkthrough, see the Windows install guide (English, 中文).
- Download the
.exeinstaller and verify it. - Run the installer. Windows SmartScreen shows Windows protected your PC because the installer is not code-signed.
- Choose More info, check that the app name is the file you verified, then choose Run anyway.
- In the installer, keep or change the installation folder. The installer creates desktop and Start Menu shortcuts named Cordy.
- Launch Cordy.
Do not turn off SmartScreen or Microsoft Defender to get past the warning.
macOS (0.5.3)
Requires an Apple Silicon Mac. For the full walkthrough, see the macOS install guide (English only).
- Download the 0.5.3
.dmgor.zipand verify it. - Open the
.dmgand drag the app to Applications, or unzip the.zipand move the app to Applications. - Open the app. Gatekeeper says Apple could not verify it is free of malware. Choose Done, not Move to Trash.
- Open System Settings → Privacy & Security, scroll to Security, and choose Open Anyway.
- In the warning that appears again, choose Open, then confirm with your password or Touch ID.
On macOS Ventura or Sonoma, Control-click the app and choose Open may also work. macOS remembers the approval for this build. Do not disable Gatekeeper.
Linux (0.5.3)
Builds exist for x64 and arm64. Pick the file that matches your machine and verify it.
- AppImage: make the file executable with
chmod +xand run it. - deb: install it with
sudo apt install ./<file>.deb, then start Cordy from your application launcher.
Sandboxed startup and AppImage mounting on an ordinary Linux desktop were not fully verified for 0.5.3. If the AppImage does not start, try the .deb package.
First launch
Use Add repository, drag a repository folder into the first-run surface, or press Ctrl+Shift+O. Cordy requires a local Git repository. It does not install or authenticate your CLI agents; configure each one before launching its preset. ripgrep, used by project search, is bundled with the app.
Updates
Cordy Desktop has no automatic updater, and it does not check for new versions. Updates are manual:
- Watch the releases page for a new Desktop release. About in the sidebar shows your installed version.
- Download and verify the new build.
- Install it over the existing one: run the new Windows installer, replace the app in Applications on macOS, install the new
.deb, or replace the AppImage file.
Installing a new version keeps your local data. Only the most recent release receives security fixes.
Some versions convert local data on first launch: 0.5.4 converts worktree workspaces, and 0.5.5 converts Markdown notes to the block format. Each conversion keeps a backup, but going back to an earlier version after the conversion is not supported. See Troubleshooting.
Where data lives
The public build is named Cordy and keeps its data in a cordy folder:
- Windows:
%APPDATA%\cordy - macOS:
~/Library/Application Support/cordy - Linux:
~/.config/cordy
Builds from other Cordy release channels use a different name and data folder, so they can be installed side by side without sharing data. Two copies of the public build cannot be installed side by side: a new installer replaces the old one and keeps the same data folder. See Privacy & Data for what the folder contains.