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 | shWindows
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' | iexOn 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/hivebun add -g @codefrontlabs/hiveUse 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-hiveArch 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.zstFor ARM64, build and install from the PKGBUILD with makepkg -si. AUR publication is pending.
Check the setup
hive doctorIt 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
- Run
hivein any directory. You get a terminal in a space named after the repository. - Type
claude,codex,geminioropencode. The sidebar picks up the agent and shows its status. - Press Ctrl+Space then : for the command palette, or Ctrl+Space d to detach. Your agents keep running; run
hiveagain 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
| Variable | Effect |
|---|---|
HIVE_INSTALL_DIR | Install somewhere other than the default directory. |
HIVE_VERSION | Pin a release, e.g. v0.4.12. |
Update
hive update
hive daemon stop # restart the daemon on the new versionIf 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 metadataWorktrees 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.