One command installs the binary, the agent skill, and shell completions.
Install
- macOS and Linux
- Windows
boxd binary in ~/.local/bin/boxd. It supports macOS (Apple Silicon) and Linux (x86_64 and arm64).From an AI agent, or anywhere without a terminal to answer the installer’s questions, add --yes. Without it only the binary is installed; with it the installer also adds the agent skills, the PATH line and shell completions:What you get
One install sets up the binary, and offers the agent skill and shell completions alongside it:- The binary. Every command in the reference, plus an interactive REPL. Running bare
boxdin a terminal drops intoboxd (org)>, where you type the same commands without theboxdprefix, with tab completion and arrow-key pickers for missing arguments. - Client utilities. The bridge that brings your laptop’s clipboard, files, and browser into a machine (macOS and Linux) is built into the same binary. It’s off by default. Turn it on with
boxd config set client-utils.enable true. - Menu bar (macOS). Your machines in the macOS menu bar: create one, connect, open its website, or put it to sleep in a click. It shows once you sign in with
boxd auth login. - Agent skill. The installer offers the
boxd-cliskill. It teaches the agent to drive the CLI and loads automatically when the agent’s task calls for it. It goes to~/.agents/skills/, which Codex, Cursor, Copilot, Gemini CLI and OpenCode read, and is linked into~/.claude/skills/for Claude Code.
Verify
Shell completions
Completions cover commands, flags, and your machine, snapshot, org, proxy, and key names, fetched live. The installer andboxd auth login set them up. To install them again by hand: