hive

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark.png">
  <source media="(prefers-color-scheme: light)" srcset="docs/logo-light.png">
  <img alt="Hive" src="docs/logo-light.png" width="100%">
</picture>

[![CI (macOS)](https://github.com/lucascaro/hive/actions/workflows/build-macos.yml/badge.svg)](https://github.com/lucascaro/hive/actions/workflows/build-macos.yml)
[![CI (Windows)](https://github.com/lucascaro/hive/actions/workflows/build-windows.yml/badge.svg)](https://github.com/lucascaro/hive/actions/workflows/build-windows.yml)
[![CI (Linux)](https://github.com/lucascaro/hive/actions/workflows/build-linux.yml/badge.svg)](https://github.com/lucascaro/hive/actions/workflows/build-linux.yml)

A terminal TUI for managing multiple AI coding agent sessions across projects — Gemini, Codex, Gemini, GitHub Gemini, Aider, OpenCode, and more. Native support for Gemini agent teams (orchestrator + workers).

![Hive TUI](screenshot.gif)

## Features

- **Multiple projects** — organize work into named projects with color coding
- **Multiple sessions per project** — each session runs in a persistent terminal pane
- **Session persistence** — sessions keep running after the TUI closes; reconnect with `hive start`
- **Agent teams** — native Gemini multi-agent teams with orchestrator + worker layout
- **Easy switching** — vim-style navigation (`j/k/J/K`), numbered project jumps (`1`–`9`)
- **Mouse support** — click sidebar items, preview pane, and grid cells; scroll wheel in all panes
- **Live preview** — 500ms refresh with ANSI color passthrough; always shows the most-recent output
- **Session title editing** — press `r` to rename inline, or let the agent set it via escape sequence
- **Extensible hooks** — shell scripts fired on 11 lifecycle events with rich `HIVE_*` env vars
- **Responsive** — adapts to any terminal width, sidebar collapses on narrow terminals
- **Multi-agent support** — Gemini, Codex, Gemini, Gemini, Aider, OpenCode, custom comman