Run Claude Code, Codex, Gemini CLI, OpenCode or any shell side by side, see at a glance which one is working, which one needs you and which one is done, and close the window without stopping any of them. Binaries for Linux, macOS and Windows.
Features
- Terminal first.
hive opens a terminal. Type claude, codex, ... to start an agent in it, or cd anywhere first. The tab row's + (or Ctrl+Space t) adds a tab; the sidebar's + new (or Ctrl+Space S) starts a new space
- Spaces follow you. Every repository or folder you work in becomes a space in the sidebar;
cd somewhere else and the tab moves there. Each space keeps its own tabs
- Live agent status. Working
◐, needs input ◆, done ●, read from the agent's screen (herdr-compatible rules) or reported by the agent itself. The AGENTS list shows every agent in every space, so you see which one needs you wherever you are
- Splits and tabs.
Ctrl+Space v / - split, t opens a tab, Alt+←/→ switches tabs, Alt+↑/↓ switches spaces
- Worktrees on demand.
Ctrl+Space C opens a terminal in its own git worktree and branch, so two agents never edit the same files. Hive warns when two agents share a directory
- Nothing dies with the window. Agents live in a background daemon (
hived). Detach, close the laptop lid or the terminal, crash the UI: reattach and get the exact screen back
- Several windows, one session. Others watch; only one types, and taking over is explicit (
Ctrl+Space a)
- Command palette.
Ctrl+Space : lists every action, session and space, fuzzy-searchable. Every key is configurable
- Right-click menus. Right-click a space (open, new terminal, rename, close), a tab (rename, split, close) or an agent (open, rename, split, terminate)
- Works anywhere. Truecolor, 256 or 16 colours,
NO_COLOR, plain ASCII without Nerd Fonts; mouse support throughout
- Safe with your work. Worktrees with uncommitted changes are never removed without
--force and confirmation; branches are never deleted
Integrations
Optional and off by default: hidden from the palette until enabled. Turn them on and off from Integrations in the menu (Ctrl+Space I, or type "integrations" in the palette): it takes effect at once and is saved to config.toml. Each opens as an ordinary session beside your agents.
| Integration | Key | What it does |
|---|
| Notes | Ctrl+Space N | Hive's own notes app on the repository's markdown or Obsidian vault, beside your agents: tree, rendered notes, wikilinks, backlinks, search, o to open in Obsidian. Agents read and add to it with hive context. With journal = true, appends "claude finished in #3 api (main)" to today's daily note |
| Review | Ctrl+Space G | lazygit, tig or git diff in a split, in the agent's directory or worktree |
| GitHub | Ctrl+Space H | gh pr checks --watch for the session's branch |
| Tasks | Ctrl+Space T | Pick a just/npm/make/cargo task and run it beside the agent |
| Desktop notifications | | A notification when an agent you aren't viewing finishes or needs input |
| Git status | | Changed files and commits ahead/behind under each repository space (main ~3 ↑2) |
| Usage | Ctrl+Space U | Token usage and cost of your agents in a pane (ccusage blocks --live by default; agents keep the logs, Hive just opens the tool) |
[integrations.obsidian]
enabled = true
journal = true
All options are in the user guide and examples/config.toml.
Layouts
Name a set of panes once and open them together with Ctrl+Space L: in a space a layout names, it opens straight away; otherwise you pick one.
[layouts.web]
spaces = ["web"] # opens without asking in the web space
panes = [
{ agent = "claude" },
{ run = ["npm", "run", "dev"], split = "right", label = "server" },
{ split = "down" }, # a terminal
]
Install
Linux (x86_64 and aarch64), macOS (Apple silicon and Intel) and Windows 10+ (x86_64 and Arm64); CI tests all three. On Windows, agent status comes only from agents that report it (hive report-agent).
Linux and macOS:
curl -fsSL https://github.com/jrh89/hive/releases/latest/download/install.sh | sh
Windows (PowerShell):
irm https://github.com/jrh89/hive/releases/latest/download/install.ps1 | iex
The script downloads static binaries, verifies their SHA-256 checksum and installs hive and hived to ~/.local/bin. Set HIVE_INSTALL_DIR to change the location or HIVE_VERSION=v0.5.9 to pin a version. Later, hive update upgrades in place (then hive daemon stop to restart the daemon on the new version; this ends running sessions, and Ctrl+Space R restores them).
From source (Rust ≥ 1.89):
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. Run hive doctor to check the setup.
How to
Start. Run hive in any directory. You get a terminal in a space named after the repository.
Run an agent. Type claude (or codex, gemini, ...) in that terminal. The sidebar's AGENTS list picks it up with its status. Or press Ctrl+Space A to pick one from a list.
Work in another repo. Click + new in the sidebar (or Ctrl+Space S): a new space opens with a terminal in your home folder. cd ~/src/other-repo and within two seconds it becomes that repository's space (or plain folder's, like ~/Work). The tab row's + adds a tab to the current space instead. Alt+↑/↓ moves between spaces, Alt+←/→ between that space's tabs.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
