GET STARTED

Install Hive

One command installs hive and its daemon hived. The installer downloads static binaries, verifies their SHA-256 checksum, and needs no root.

Linux and macOS

For Linux on x86_64 or ARM64 and macOS on Apple silicon or Intel. Binaries go to ~/.local/bin.

curl -fsSL https://github.com/jrh89/hive/releases/latest/download/install.sh | sh

Windows

For Windows 10 or later on x86_64 or Arm64, in PowerShell (Windows PowerShell or PowerShell 7). Binaries go to %LOCALAPPDATA%\hive\bin, which the installer adds to your user PATH.

irm 'https://github.com/jrh89/hive/releases/latest/download/install.ps1' | iex

On Windows, agent status comes from agents that report it with hive report-agent, and terminals stay in the space they started in.

Package managers

npm, Bun, pnpm, and Yarn

npm install -g @codefrontlabs/hive
bun add -g @codefrontlabs/hive

Use pnpm add -g @codefrontlabs/hive with pnpm or yarn dlx -p @codefrontlabs/hive hive with Yarn. Yarn may hold new versions for up to 24 hours by default. The launcher uses Node.js. If you only have Bun, use bunx --bun @codefrontlabs/hive. GitHub Releases also has the npm package archive.

Homebrew

brew tap jrh89/hive https://github.com/jrh89/hive && brew install jrh89/hive/codefront-hive

Arch Linux

Install the GitHub release with pacman on x86_64. The command downloads the Arch package and its checksum, then verifies and installs it.

curl -fLO https://github.com/jrh89/hive/releases/download/v0.5.11/codefront-hive-bin-0.5.11-1-x86_64.pkg.tar.zst && curl -fLO https://github.com/jrh89/hive/releases/download/v0.5.11/codefront-hive-bin-0.5.11-1-x86_64.pkg.tar.zst.sha256 && sha256sum -c codefront-hive-bin-0.5.11-1-x86_64.pkg.tar.zst.sha256 && sudo pacman -U ./codefront-hive-bin-0.5.11-1-x86_64.pkg.tar.zst

For ARM64, build and install from the PKGBUILD with makepkg -si. AUR publication is pending.

Check the setup

hive doctor

It shows the version, config file, daemon socket, logs, how the interface will look in your terminal, and which agents it found on your PATH. It is also the first thing to include in a bug report.

First run

  1. Run hive in any directory. You get a terminal in a space named after the repository.
  2. Type claude, codex, gemini or opencode. The sidebar picks up the agent and shows its status.
  3. Press Ctrl+Space then : for the command palette, or Ctrl+Space d to detach. Your agents keep running; run hive again to come back.

Install and sign in to each agent separately. Hive runs the agent's own CLI and leaves its permission prompts to you.

Installer options

VariableEffect
HIVE_INSTALL_DIRInstall somewhere other than the default directory.
HIVE_VERSIONPin a release, e.g. v0.4.12.

Update

hive update
hive daemon stop   # restart the daemon on the new version

If you installed with a package manager, update with the same manager. Stopping the daemon ends running sessions (it lists them and asks first). The next hive starts the new daemon, and Ctrl+Space R restores the sessions, with agents resuming their conversations.

Manual download

Download the archive for your OS and CPU from GitHub Releases, verify its SHA-256 checksum, and extract hive and hived into the same directory on your PATH.

Build from source

Needs Rust 1.89 or later.

git clone https://github.com/jrh89/hive && cd hive
cargo build --release
install -m 0755 target/release/hive target/release/hived ~/.local/bin/

Keep hive and hived in the same directory.

Uninstall

hive daemon stop
rm ~/.local/bin/hive ~/.local/bin/hived
rm -rf ~/.config/hive ~/.local/state/hive   # config, logs, session metadata

Worktrees under ~/.local/share/hive/worktrees may hold your work: check them first. On Windows, stop the daemon, then delete %LOCALAPPDATA%\hive and the config and state folders hive doctor lists.

Explore integrations All release files