convez.ai
BomPluginScore · de 0 a 100

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/hive

1 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

Estrelas
11
Forks
1
Acompanhando
0
Saúde
85%
Último commit
há 1 dia
Versão
v2.9.0
Issues abertas
19
Contribuidores
3

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.

main is now Hive v2 — the native daemon + GUI rewrite. The legacy tmux-backed TUI (Hive v1, v0.14.x) lives on the release/v1 branch for bug fixes. See docs/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

KeyAction
⌘NNew session (agent launcher)
⇧⌘NNew window
⌘WKill active session
⇧⌘WClose this window
⇧⌘PNew project
⌘G / ⇧⌘GPer-project grid / all-sessions grid
⌘EnterToggle grid / single
⌘arrowsSpatial nav (grid) / session nav (single)
⌘[ / ⌘]Previous / next project
⌘1–9Jump to nth session
⌘= / ⌘- / ⌘0Font size up / down / reset
⌘SToggle 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.

Ver o original no GitHub

Bom para

Relacionados