Install pre-built tools with a single command, switch versions instantly, and run with clean environments. Designed as a backend for GitHub Actions, Bazel rules, and CI/CD pipelines.
# Install ocx
curl -fsSL https://ocx.sh/install.sh | sh
# Install a package
ocx install cmake:3.28
# Run with a clean environment
ocx exec cmake:3.28 -- cmake --version
# Switch versions
ocx install cmake:3.29 --select
ocx select cmake:3.28 # switch backSee the Getting Started guide for more.
# macOS / Linux
curl -fsSL https://ocx.sh/install.sh | sh
# Windows (PowerShell)
irm https://ocx.sh/install.ps1 | iexSee the installation guide for all options including manual downloads and updating.
- User Guide — architecture, versioning, locking, authentication
- Command Reference — all commands, flags, and options
- FAQ — platform-specific behavior, design decisions
See CONTRIBUTING.md for the full guide. Quick start:
git clone --recurse-submodules https://github.com/ocx-sh/ocx.git
cd ocx
task # check: fmt + clippy + cargo check
task test # acceptance tests (requires Docker)
task verify # full verification suitePrerequisites: Rust, task, Docker, uv
OCX is licensed under the Apache License, Version 2.0.