> ## Documentation Index
> Fetch the complete documentation index at: https://ocx.kdco.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install OCX on macOS, Linux, or Windows using the install script or npm

## Overview

OCX supports macOS (x64, Apple Silicon), Linux (x64, arm64), and Windows (x64). Choose the method that fits your environment.

## Install via Shell Script (Recommended)

The install script handles PATH configuration automatically or prints instructions if manual setup is needed.

```bash theme={null}
curl -fsSL https://ocx.kdco.dev/install.sh | sh
```

<Tip>
  This method downloads a pre-built binary and verifies it with SHA-256 checksums. It is the fastest way to get started on macOS or Linux.
</Tip>

## Install via npm

Use npm if you prefer a package-manager-based install or are on Windows:

```bash theme={null}
npm install -g ocx
```

The npm-installed CLI requires Bun on your `PATH` at runtime. Node.js alone is not sufficient. If you do not have Bun installed, use the standalone binaries from the install script or GitHub Releases when available.

## Verify Your Installation

After installing, confirm OCX is available:

```bash theme={null}
ocx --version
```

You should see the installed version number printed to the terminal.

## Updating

OCX can update itself:

```bash theme={null}
ocx self update
```

The update mechanism auto-detects how OCX was originally installed (curl or npm) and uses the appropriate method. For curl-installed binaries, the downloaded binary is verified against published SHA-256 checksums.

## Uninstalling

To remove OCX and its global configuration:

```bash theme={null}
ocx self uninstall
```

Preview what would be removed first with `--dry-run`:

```bash theme={null}
ocx self uninstall --dry-run
```

## Next Steps

* [Quick Start](/docs/getting-started/quick-start) — Set up your first profile and launch OpenCode.
* [CLI Reference](/docs/cli/commands) — Full command documentation.