Installation

oops is available for Linux, macOS, and Windows. Choose the installation method that works best for you.

Quick Install (One-Liner)

The fastest way to get started is using our install scripts:

Linux / macOS

curl -fsSL https://animeshkundu.github.io/oops/install.sh | bash

This script will:

  • Detect your OS and architecture automatically
  • Download the correct binary from GitHub releases
  • Install to /usr/local/bin (or ask for sudo)
  • Print shell integration instructions

Windows (PowerShell)

irm https://animeshkundu.github.io/oops/install.ps1 | iex

This script will:

  • Download the Windows binary
  • Install to %LOCALAPPDATA%\oops
  • Add the installation directory to your PATH

Package Managers

Homebrew (macOS/Linux)

brew install animeshkundu/tap/oops

Cargo (Rust)

If you have Rust installed:

cargo install --git https://github.com/animeshkundu/oops
Note

Building from source requires Rust 1.88 or newer.

Pre-built Binaries

Download pre-built binaries from GitHub Releases:

Platform Architecture Binary
Linux x86_64 oops-linux-x86_64
Linux x86_64 (static) oops-linux-x86_64-musl
Linux ARM64 oops-linux-aarch64
macOS Intel oops-darwin-x86_64
macOS Apple Silicon oops-darwin-aarch64
Windows x86_64 oops-windows-x86_64.exe

Manual Install (Linux/macOS)

# Download (example for Linux x86_64)
curl -LO https://github.com/animeshkundu/oops/releases/latest/download/oops-linux-x86_64

# Make executable
chmod +x oops-linux-x86_64

# Move to PATH
sudo mv oops-linux-x86_64 /usr/local/bin/oops

# Verify installation
oops --version

Manual Install (Windows)

# Download using PowerShell
Invoke-WebRequest -Uri "https://github.com/animeshkundu/oops/releases/latest/download/oops-windows-x86_64.exe" -OutFile "oops.exe"

# Create directory and move
mkdir -Force "$env:USERPROFILE\bin"
Move-Item oops.exe "$env:USERPROFILE\bin\oops.exe"

# Add to PATH (run once)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\bin", "User")

Verify Installation

After installation, verify oops is working:

oops --version

You should see output like:

oops 0.1.1

Next Steps

After installing the binary, you need to set up shell integration:

Shell Integration Guide →

Uninstalling

To uninstall oops:

  1. Remove the shell integration line from your shell config file
  2. Delete the binary:
    • Linux/macOS: sudo rm /usr/local/bin/oops
    • Windows: Remove-Item "$env:LOCALAPPDATA\oops" -Recurse
  3. Optionally, remove configuration: rm -rf ~/.config/oops