hive
lucascaro/hive
A terminal TUI for managing multiple AI coding agent sessions across projects — Claude, Codex, Gemini, GitHub Copilot, Aider, OpenCode, and more.
Instalação
npx convez-ai lucascaro/hive1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Hive
A native desktop app for managing multiple AI coding agent sessions — Claude, Codex, Gemini, Copilot, Aider, plain shells — across projects.
mainis now Hive v2 — the native daemon + GUI rewrite. The legacy tmux-backed TUI (Hive v1,v0.14.x) lives on therelease/v1branch for bug fixes. Seedocs/native-rewrite/for v2 design docs (PLAN.md plus per-phase notes).
Status
Alpha. The v2 architecture is feature-complete for daily use; the download is pre-release. Latest release: v2.0.0-alpha.1.
What works:
- Multi-session daemon (
hived) — sessions persist across GUI restart - Wails-based desktop GUI with xterm.js — full keyboard control, font scaling, dark theme
- Projects (name, color, working dir) — sidebar tree
- Agent launcher (Claude, Codex, Gemini, Copilot, Aider, shell)
- Grid view: per-project (⌘G) or all-sessions (⇧⌘G), spatial arrow nav
- Multi-window (⇧⌘N) — independent windows share the same daemon
- BEL → desktop notification + visual pulse on non-focused sessions
Not yet shipping: scrollback resume across daemon restart, splits inside grid cells, workflows / agent teams, code signing.
Build
Requires Go 1.22+, Node 18+, and the Wails CLI:
go install github.com/wailsapp/wails/v2/cmd/wails@latest
Then from the repo root:
./build.sh # macOS .app at cmd/hivegui/build/bin/hivegui.app
./build.sh --open # build then launch
./build.sh --zip --version v2.0.0-alpha.2 # also write release/<name>.zip
For Windows or Linux, build the GUI and the daemon separately:
# Windows (cross-build from macOS works)
( cd cmd/hivegui && wails build -platform windows/amd64 )
GOOS=windows GOARCH=amd64 go build -o cmd/hivegui/build/bin/hived.exe ./cmd/hived
# Linux (build natively)
( cd cmd/hivegui && wails build -platform linux/amd64 )
GOOS=linux GOARCH=amd64 go build -o cmd/hivegui/build/bin/hived ./cmd/hived
hivegui and hived must live in the same directory; the GUI
auto-spawns the daemon at startup.
Updating
Tagged release builds check GitHub for newer releases automatically: once on launch and every six hours. When a newer tag is found, the GUI shows an "Update available" banner with a one-click link to the release page. The check is also reachable manually from File → Check for Updates….
The check is a single anonymous GET to
api.github.com/repos/lucascaro/hive/releases/latest (no
identifying data beyond a User-Agent: hivegui/<build-id> header).
Untagged dev builds — anything built without ./build.sh --version <tag> — skip the check entirely and never call out.
Layout
cmd/
hived/ # session daemon
hivegui/ # Wails GUI client
internal/
wire/ # protocol v1 (frame format + JSON control messages)
session/ # one PTY + scrollback
registry/ # sessions + projects + persistence
daemon/ # socket listener + dispatch
agent/ # built-in agent launcher catalog
docs/
native-rewrite/ # v2 design docs (PLAN.md, phase-{0..5}.md)
spikes/ # phase-0 reference code (kept for posterity)
build.sh # macOS universal build
Keybinds
| Key | Action |
|---|---|
| ⌘N | New session (agent launcher) |
| ⇧⌘N | New window |
| ⌘W | Kill active session |
| ⇧⌘W | Close this window |
| ⇧⌘P | New project |
| ⌘G / ⇧⌘G | Per-project grid / all-sessions grid |
| ⌘Enter | Toggle grid / single |
| ⌘arrows | Spatial nav (grid) / session nav (single) |
| ⌘[ / ⌘] | Previous / next project |
| ⌘1–9 | Jump to nth session |
| ⌘= / ⌘- / ⌘0 | Font size up / down / reset |
| ⌘S | Toggle sidebar |
Contributing
See AGENTS.md for repo-wide rules and CONTRIBUTING.md for the
contribution flow. The native rewrite has its own design docs under
docs/native-rewrite/.
License
MIT — see LICENSE.