Installation

Requirements

An Apple Silicon Mac on macOS 14 or later. There is no Intel build in the alpha and no plan for Linux or Windows.
Nothing else. Language servers are optional and found if they are installed.

Install the app

Download
Build from source

Download crc.dmg, the newest release’s disk image.
Download crc.dmg Release notes
Open it and drag crc to Applications.

The app is signed with a Developer ID and notarized, so it opens without a Gatekeeper warning.
Optionally, check the download against SHA256SUMS from the same release:
Terminal window
```
shasum -a 256 ~/Downloads/crc.dmg
```
The hash printed should match the line for that file in SHA256SUMS.

You need Rust 1.98 or newer. The repository pins the exact toolchain in rust-toolchain.toml, so rustup fetches it for you.

Clone the repository:

git clone https://github.com/caioricciuti/crc
cd crc

Build the bundle and install it:
Terminal window
```
scripts/bundle.sh --install
```
That puts an ad-hoc signed crc.app in /Applications.
For a fully offline, auditable build, vendor the crates first:
Terminal window
```
scripts/vendor.sh
```

Open files and folders

From Finder, drop a file or folder on the Dock icon. From a terminal:

open -a crc path/to/file    # open a file
open -a crc .               # open the current folder as a project

Inside crc, ⌘O opens a file and ⌘⇧O opens a folder. Recent folders are on the home screen.

Updates

Once a day crc asks GitHub for the list of releases and says in the status line when a newer one exists. Help › Check for Updates opens its page. Nothing is downloaded or installed for you; download the new DMG and replace the app. Set update_check = false in settings to turn the daily check off.

Uninstall

Drag crc.app from Applications to the Trash. crc also keeps a few files of its own; Where crc keeps things lists them if you want to remove those too.