Installation

Prerequisites

• Claude CLI — Required for Claude Code workers. See Claude Code documentation for installation.
• Go 1.25+ (only if building from source)
• Node.js 20+ (only if building from source)

Install via npm

npm install -g @theopenbee/cli

Install via Script

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/theopenbee/openbee/main/install.sh | bash

Install via Package Manager

macOS (Homebrew):

brew install theopenbee/tap/openbee

Windows (Scoop):

scoop bucket add theopenbee https://github.com/theopenbee/scoop-bucket.git
scoop install openbee

Build from Source

git clone https://github.com/theopenbee/openbee.git
cd openbee
make build  # Build binary

The binary will be at ./dist/openbee.

Verify Installation

openbee --version

You should see the version number, commit hash, and build date.

Troubleshooting

Claude Code Cannot Run as Root User

If you see the following error when starting a Claude Code worker:

dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

This is a security restriction enforced by Claude Code — it refuses to run with --dangerously-skip-permissions under root or sudo privileges.

Solution: Run OpenBee as a non-root user.

# Create a dedicated user (e.g., openbee)
useradd -m openbee

# Switch to that user and run OpenBee
su - openbee
openbee server -d

Alternatively, if you are already logged in as a non-root user, make sure you are not using sudo to start OpenBee.