Installation

Quick Install

macOS / Linux

1. Download the release archive for your platform from the releases page.
2. Extract it and run the installer:

   tar -xvf chuks-darwin-arm64.tar.gz
   cd chuks-darwin-arm64
   ./scripts/install.sh

   The installer places the binary in ~/chuks/bin/ and adds it to your PATH automatically.
3. Open a new terminal (or run source ~/.zshrc) and verify:

   chuks --version

Windows

1. Download chuks-windows-amd64.zip from the releases page.
2. Extract the ZIP and move chuks.exe into a folder such as %USERPROFILE%\chuks\bin\.
3. Add the folder to your System PATH:
   • Search for “Edit the system environment variables” in the Start menu.
   • Click “Environment Variables”.
   • Under “User variables”, find Path and click “Edit”.
   • Click “New” and add %USERPROFILE%\chuks\bin.
   • Click OK to save.
4. Open a new Command Prompt or PowerShell and verify:

   chuks --version

Manual Install

1. Download the archive for your platform:
   • chuks-darwin-amd64.tar.gz — macOS Intel
   • chuks-darwin-arm64.tar.gz — macOS Apple Silicon
   • chuks-linux-amd64.tar.gz — Linux x86_64
   • chuks-linux-arm64.tar.gz — Linux ARM64
   • chuks-windows-amd64.zip — Windows x86_64
2. Extract and move the binary:

   tar -xvf chuks-darwin-arm64.tar.gz
   mkdir -p ~/chuks/bin
   mv chuks-darwin-arm64/chuks ~/chuks/bin/

3. Add ~/chuks/bin to your PATH (add to ~/.zshrc, ~/.bashrc, or ~/.profile):

   echo 'export PATH="$HOME/chuks/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc

4. Verify:

   chuks --version

Supported Platforms

Platform	Architecture	Archive
macOS	Intel (x86_64)	chuks-darwin-amd64.tar.gz
macOS	Apple Silicon (ARM64)	chuks-darwin-arm64.tar.gz
Linux	x86_64	chuks-linux-amd64.tar.gz
Linux	ARM64	chuks-linux-arm64.tar.gz
Windows	x86_64	chuks-windows-amd64.zip

Editor Support

For the best experience, install the official Chuks VS Code extension from the marketplace. It provides:

• Syntax highlighting
• Code completion
• Hover documentation
• Direct CLI integration

Upgrading

If you already have Chuks installed, upgrade to the latest version with:

chuks upgrade

Install a specific version:

chuks upgrade 0.0.3

List all available versions:

chuks upgrade --list

The upgrade command automatically detects your platform, downloads the correct binary, and replaces the existing installation. On macOS, code signing is handled automatically.

Next Steps

Now that Chuks is installed, try writing your first program.