Install

Install the published 0.3.0 Windows build or run the 0.4.0 source and draft-release state.

Release status

  • Latest published GitHub Release: 0.3.0, published 2026-09-04.
  • Verified published asset: cordy-Setup-0.3.0.exe (Windows x64, 117,589,600 bytes).
  • Current source/tag: 0.4.0.
  • 0.4.0 GitHub Release: draft, with no published download.

Do not treat the 0.4.0 tag or draft asset as a published installer. There are no verified published macOS or Linux assets in the 0.3.0 Release.

Install the published Windows build

  1. Download cordy-Setup-0.3.0.exe from the published Release.
  2. Run the installer.
  3. Because the installer is not code-signed, Windows SmartScreen may show Windows protected your PC. Choose More info → Run anyway only after confirming you obtained the expected asset.
  4. Launch Cordy and import a local Git repository.

Cordy has no automatic updater in the documented current flow. Install a newer published build over the existing application when one becomes available; keep the same user-data directory to retain local state.

Run from source

Prerequisites:

  • Node.js 24 or newer;
  • pnpm 10.30.2 through Corepack;
  • Git;
  • Rust from the repository's rust-toolchain.toml;
  • platform build tools required by Electron and Rust. On Windows, install Visual Studio Build Tools with the Desktop development with C++ workload.

From the repository root:

corepack enable
pnpm install
pnpm runtime:build
pnpm dev

pnpm runtime:build builds the Rust server and places the required ConPTY files for development. Keep that terminal open while using the dev app.

Build packages

pnpm dist:win:prod
pnpm dist:mac
pnpm dist:linux

These commands describe source build capability. They do not mean packages exist on the published Release.

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.