Getting Started

Start with Cordy Desktop, the local workspace for repositories, terminals, CLI agents, project tools, block notes, and a built-in browser.

Cordy Desktop is a local-first workbench for a repository. It combines workspaces, supervised terminal tabs, external CLI agents, file and Git tools, block-editor notes, search, diagnostics, and a manual built-in browser.

Cordy does not embed its own chat model. CLI agents use their own configuration, accounts, and provider connections. Cordy renders their terminal output and shows their status.

Download

Public builds are published in the public releases repository. See Install for the download, platform steps, and updates.

  • Windows x64: 0.6.0, the current release. The installer is not code-signed.
  • macOS (Apple Silicon) and Linux (x64, arm64): 0.5.3 is the latest build. 0.5.4, 0.5.5, and 0.6.0 were published for Windows only.
  • Windows on ARM and Intel Macs: no build.

This manual describes 0.6.0. Features added in 0.5.4 or later, such as the block-editor notes, are not in the 0.5.3 macOS and Linux builds.

First workflow

  1. Install the build for your platform.
  2. Choose Add repository, drop a repository folder, or press Ctrl+Shift+O.
  3. Select the project and create a workspace. Each workspace works in the project's own checkout.
  4. Open a terminal tab or launch an installed agent preset.
  5. Use Project Tools to edit files, search the project, inspect Git changes, or read the commit graph.
  6. Keep task notes in the workspace, and use the browser for manual web work.

What a workspace contains

  • one code target: the project root;
  • terminal tabs and split panes, with shell and agent processes owned by the Rust runtime;
  • one block-editor note, stored locally;
  • open file tabs and layout state;
  • project-wide Files, Search, Changes, and Graph views.

Cordy no longer creates or manages Git worktrees. For a separate checkout, run git worktree add yourself and add that folder as its own project. See Concepts.

Durability boundary

On Windows, closing the main window to the tray keeps the runtime and live PTYs running. Reopening the window reattaches to the live sessions. A full quit ends the processes; on next launch Cordy restores a local terminal screen/history snapshot above a fresh shell. See Terminal and Runtime.

Next