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

# Installation

> Install the boxd CLI and get your terminal talking to your machines.

The boxd CLI manages machines from your local terminal. It talks to the boxd API directly, so it works without SSH keys, and it is the recommended surface for automation and coding agents.

<Frame caption="One command installs the binary, the agent skills, and shell completions.">
  <video autoPlay muted loop playsInline src="https://mintcdn.com/azin/psRZbQh2QwMUVL3U/videos/install-cli.mp4?fit=max&auto=format&n=psRZbQh2QwMUVL3U&q=85&s=69e65be62688af8337b553464b7a14d3" data-path="videos/install-cli.mp4" />
</Frame>

## Install

```bash theme={"theme":"github-dark"}
curl -fsSL https://boxd.sh/downloads/install.sh | sh
```

The installer puts the `boxd` binary in `~/.local/bin/boxd`. It supports macOS (Apple Silicon) and Linux (x86\_64 and arm64).

## What you get

One install sets up three things:

* **The binary.** Every command in the [reference](/cli/commands), plus an interactive REPL. Running bare `boxd` in a terminal drops into `boxd (org)>`, where you type the same commands without the `boxd` prefix, with tab completion and arrow-key pickers for missing arguments.
* **Client utilities.** The [bridge](/guides/client-utilities) that brings your clipboard, local files, and browser into a machine (macOS Apple Silicon for now) is built into the same binary. It's off by default. Turn it on with `boxd config set client-utils.enable true`.
* **Agent skill.** The installer drops the [`boxd-cli` skill](/reference/skills) for Claude Code, Codex, and OpenCode. It teaches the agent to drive the CLI and loads automatically whenever the agent works with boxd. Claude Code picks it up from `~/.claude/skills/`, and when Codex or OpenCode is on your laptop the same skill lands in their skill directories too.

## Verify

```bash theme={"theme":"github-dark"}
boxd version
```

## Shell completions

Tab-completes commands, flags, and your machine, snapshot, org, proxy, and key names, fetched live. Completions are set up automatically by the installer and on `boxd auth login`. To (re)install manually:

```bash theme={"theme":"github-dark"}
boxd completions --install       # auto-detects your shell, idempotent
boxd completions zsh             # or print the raw script yourself
```

## Upgrade

Re-run the installer any time. It upgrades the binary and the skills together.

```bash theme={"theme":"github-dark"}
curl -fsSL https://boxd.sh/downloads/install.sh | sh
```

## Next step

The CLI is installed. [Log in](/cli/authentication) next, then browse the full [command reference](/cli/commands).