Installation

coderaft runs on Linux, macOS, and Windows. All platforms require Docker.

Source of Truth: Install scripts pull from the main branch and build locally. Always get coderaft from itzcozi/coderaft.

Linux

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/install.sh | bash

Supports Debian, Ubuntu, Fedora, CentOS, RHEL, Arch, openSUSE, Alpine, and derivatives. The script installs dependencies, builds coderaft, and sets up permissions.

macOS

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install-macos.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/install-macos.sh | bash

Installs Homebrew (if needed), Go, Git, Docker Desktop, then builds and installs coderaft.

Windows

irm https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/install.ps1 | iex
# or mirror: irm https://coderaft.ar0.eu/install.ps1 | iex

Requires Git and Go. The script clones, builds, and adds coderaft to your PATH.

Manual Build

For all platforms, you can build manually:

Prerequisites: Git, Go, Docker

git clone https://github.com/itzcozi/coderaft.git
cd coderaft
go build -o coderaft ./cmd/coderaft

Install:

Linux/macOS: sudo cp coderaft /usr/local/bin/
Windows: Move coderaft.exe to a directory in your PATH

Shell Completion

# Bash
coderaft completion bash > /etc/bash_completion.d/coderaft

# Zsh
coderaft completion zsh > "${fpath[1]}/_coderaft"

# Fish
coderaft completion fish > ~/.config/fish/completions/coderaft.fish

# PowerShell
coderaft completion powershell >> $PROFILE

Uninstall

Linux

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/uninstall.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/uninstall.sh | bash

macOS

curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/uninstall-macos.sh | bash
# or mirror: curl -fsSL https://coderaft.ar0.eu/uninstall-macos.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/itzcozi/coderaft/main/scripts/uninstall.ps1 | iex
# or mirror: irm https://coderaft.ar0.eu/uninstall.ps1 | iex

File Locations

	Linux/macOS	Windows
Projects	`~/coderaft/<project>/`	`%USERPROFILE%\coderaft\<project>\`
Config	`~/.coderaft/config.json`	`%USERPROFILE%\.coderaft\config.json`
Workspace	`/island/` (inside container)	`/island/` (inside container)

Next Steps

→ Quick Start