Installation

Quick Install (Recommended)

The fastest way to get cora — single command, no Rust required:

$ curl -fsSL https://raw.githubusercontent.com/codecoradev/cora-code/main/install.sh | sh

Installs to ~/.local/bin. Add to PATH if needed:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Pin a specific version:

$ CORA_VERSION=v0.13.0 curl -fsSL https://raw.githubusercontent.com/codecoradev/cora-code/main/install.sh | sh

Install via Cargo

If you have Rust 1.85+ installed:

$ cargo install cora-code

This compiles cora from source and installs it to Cargo's binary directory (typically ~/.cargo/bin/).

Download Binary

Pre-built binaries are available from the GitHub Releases page.

Supported platforms:

• Linux x86_64 (glibc)
• Linux arm64 (aarch64)
• macOS arm64 (Apple Silicon)
• Windows x86_64

# Download and extract (Linux x86_64 example)
$ curl -sL https://github.com/codecoradev/cora-code/releases/latest/download/cora-x86_64-unknown-linux-gnu-v0.13.0.tar.gz | tar xz
$ mv cora ~/.local/bin/cora

Asset naming convention: cora-{target-triple}-{version}.tar.gz (Linux/macOS) or .zip (Windows). Replace the target triple as needed:

Platform	Asset name
Linux x86_64	cora-x86_64-unknown-linux-gnu-v0.13.0.tar.gz
Linux ARM64	cora-aarch64-unknown-linux-gnu-v0.13.0.tar.gz
macOS ARM64	cora-aarch64-apple-darwin-v0.13.0.tar.gz
Windows x86_64	cora-x86_64-pc-windows-msvc-v0.13.0.zip

Build from Source

If you prefer to build from the latest source:

$ git clone https://github.com/codecoradev/cora-code.git
$ cd cora-code
$ cargo build --release
# Binary at target/release/cora

Shell Completions

cora provides shell completions for bash, zsh, and fish:

# Bash
$ cora completion bash > ~/.cora/completion.bash
$ echo 'source ~/.cora/completion.bash' >> ~/.bashrc

# Zsh
$ cora completion zsh > ~/.cora/completion.zsh
$ echo 'source ~/.cora/completion.zsh' >> ~/.zshrc

# Fish
$ cora completion fish > ~/.config/fish/completions/cora.fish

Verify Installation

Confirm cora is installed correctly:

$ cora --version
cora 0.13.0

$ cora auth status
Provider: openai
API key: configured

Check for stale copies on PATH

cora is distributed through multiple channels (installer script, cargo, pre-built binaries). If you have more than one installed, which cora resolves to whichever appears first in $PATH — which may silently be a stale version.

# List every `cora` on your PATH (one entry = healthy)
$ which -a cora
/Users/you/.local/bin/cora

# Should match the latest release
$ cora --version
cora 0.13.0

If which -a cora shows more than one path (e.g. ~/.local/bin/cora and ~/.cargo/bin/cora), remove the one you don't want or reorder your PATH. See Issue #314 for background.

macOS: Killed: 9 on launch?

Prebuilt macOS binaries (aarch64-apple-darwin) are not Apple-notarized. When downloaded directly (via browser, curl, or gh release download), macOS attaches com.apple.quarantine / com.apple.provenance extended attributes and kills the binary on first launch with Killed: 9 and no error message.

The install.sh installer strips these attributes automatically. If you downloaded the binary manually, strip them yourself:

$ xattr -dr com.apple.quarantine /path/to/cora
$ xattr -dr com.apple.provenance /path/to/cora

Or install via cargo / Homebrew to sidestep Gatekeeper entirely.

Updating

To update cora to the latest version:

Method	Command
Via Cargo	cargo install cora-code --force
Via Binary	Download the latest release from GitHub and replace the existing binary