Install Oscar

Oscar ships as prebuilt binaries for macOS and Linux. Windows users can run Oscar through WSL2.

curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-install.sh | bash

After Install

Set up model access, then launch Oscar in the terminal:

export ANTHROPIC_API_KEY="sk-ant-..."
oscar

If you use AWS Bedrock instead:

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
oscar

Direct Downloads

These are standalone binaries. Download the one for your platform, make it executable, and move it onto your PATH.

Platform	Download
macOS Apple Silicon	oscar-macos-arm64
macOS Intel	oscar-macos-x64
Linux x64	oscar-linux-x64
Linux ARM64	oscar-linux-arm64

macOS

Download the binary, make it executable, and place it on your PATH:

# Apple Silicon
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-arm64 -o oscar

# Intel
# curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-macos-x64 -o oscar

chmod +x oscar
mkdir -p "${HOME}/.local/bin"
mv oscar "${HOME}/.local/bin/oscar"

If ~/.local/bin is not already on your PATH, add it to your shell config (e.g. ~/.zshrc):

export PATH="$HOME/.local/bin:$PATH"

If macOS blocks the binary because it was downloaded from the internet:

xattr -d com.apple.quarantine "${HOME}/.local/bin/oscar"

Linux

# x64
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-x64 -o oscar

# ARM64
# curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-linux-arm64 -o oscar

chmod +x oscar
mkdir -p "${HOME}/.local/bin"
mv oscar "${HOME}/.local/bin/oscar"

If ~/.local/bin is not already on your PATH, add it to your shell config (e.g. ~/.bashrc):

export PATH="$HOME/.local/bin:$PATH"

Windows (WSL2)

Oscar runs on Windows through WSL2. Install WSL2 with a Linux distribution (Ubuntu recommended), then run the installer inside your WSL2 terminal:

# From a WSL2 terminal (e.g. Ubuntu)
curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/oscar-install.sh | bash

This installs the Linux x64 binary, which runs natively inside WSL2.

Verify Downloads

Oscar publishes a checksum manifest with every release:

curl -fsSL https://github.com/TheRealOpsCanvas/public/releases/download/oscar-latest/checksums.txt

Use it to verify any binary or installer you download manually.