# Installing OX

> ⚠️ **Work in progress.** OX is an early, opinionated personal tool, not a polished product. Don't install it unless you're comfortable running and updating it yourself — including re-running `ox index` manually to keep results fresh. See [Status & Known Issues](https://iamox.ai/docs/known-issues.md) first.

OX v0.3.0 ships two implementations, both producing a binary named `ox`. The one-liner below installs the **Go CLI**. See [Two Implementations](https://iamox.ai/docs/two-implementations.md) for the Rust port (ox-rs).

## One-line install

```bash
curl -fsSL https://iamox.ai/install.sh | bash
```

The installer detects your platform, fetches the latest release from [`icewaterlabs/ox`](https://github.com/icewaterlabs/ox), installs the binary to `~/.local/bin/ox`, and offers to add that directory to your `PATH`.

> **Note:** The installer downloads the **Go CLI** (`ox` v0.3.0). The Rust implementation (`ox-rs` v0.2.0) is available as a separate binary on the releases page — see [Two Implementations](https://iamox.ai/docs/two-implementations.md).

> **Platform note for ox-rs:** ox-rs Linux binaries require GLIBC 2.39+ (Ubuntu 24.04+, Fedora 40+). macOS and Windows are unaffected. The Go CLI has no GLIBC restriction.

## Bootstrap a workspace

```bash
ox init
```

`ox init` creates the directory tree, installs CLI dependencies, authenticates with GitHub, clones your organization's repos, and configures MCP servers — idempotent and safe to re-run.

```
$ ox init
  [1/9] Pre-flight checks... ok
  [2/9] Creating ~/ox directory tree... ok
  [3/9] Installing dependencies... ok
  [4/9] Configuring git... ok
  [5/9] Cloning org repos... 12 repos cloned
  [6/9] Syncing dotfiles... ok
  [7/9] Generating .ox/config.json... ok
  [8/9] Setting up MCP server... ok
  [9/9] Post-init verification... ok

  OX workspace ready at ~/ox
  Knowledge: o/o/ (0 notes)
  Code: x/code/ (12 repos)
  Agents: .agents/ configured
```

### Useful `ox init` flags

| Flag | Purpose |
|------|---------|
| `--path` | Workspace path (default: `~/ox`) |
| `--org` | GitHub organization to clone |
| `--dotfiles` | Dotfiles repo, e.g. `yourname/ox-dotfiles` |
| `--branch` | Dotfiles repo branch (default `main`) |
| `--parallel` | Max parallel git clones (default 4) |
| `--skip-clone` | Skip repository cloning |
| `--skip-deps` | Skip CLI dependency installation |
| `--skip-dotfiles` | Skip dotfiles sync |
| `--skip-mcp` | Skip MCP server configuration |

## Verify

```bash
ox version
ox status      # workspace health and status
```

## Next steps

- [CLI Reference](https://iamox.ai/docs/cli.md) — every command
- [Two Implementations](https://iamox.ai/docs/two-implementations.md) — Go CLI vs ox-rs
- [Knowledge Graph & RAG](https://iamox.ai/docs/knowledge-graph-rag.md) — run `ox index` then `ox search`
- [MCP Server](https://iamox.ai/docs/mcp-server.md) — connect your AI agent