hive

README

Hive

A lightweight TUI for managing tmux sessions, optimized for AI coding agents.

Why Hive?

Managing multiple AI coding agents (Claude, Pi, Cursor) across projects gets messy fast. Hive solves this.

Problem: Juggling tmux sessions manually - creating, naming, finding, switching.

Solution: A single interface to manage all your agent sessions.

Features

Feature	What it solves
Unified Dashboard	See all sessions at a glance - status, tool, path
Quick Search	Find sessions instantly with / - no more tmux ls
CLI + JSON Output	AI agents can create/manage sessions programmatically
12 Themes	Match your terminal aesthetic
Lightweight	~4MB binary, instant startup, no runtime deps

Requirements

• tmux - Terminal multiplexer

Installation

Works on: macOS, Linux

curl -fsSL https://raw.githubusercontent.com/mdipanjan/hive/main/install.sh | bash

Then run: hive

Other install methods

From Source

git clone https://github.com/mdipanjan/hive.git
cd hive
make build
sudo mv hive /usr/local/bin/

Go

go install github.com/mdipanjan/hive@latest

Usage

TUI Mode

hive

Keyboard Shortcuts:

Key	Action
n	New session
enter	Attach to session
d	Delete session
/	Search sessions
t	Cycle themes
?	Help
q	Quit

CLI Mode (AI-Agent Compatible)

# List sessions
hive list              # Plain text
hive list --json       # JSON output

# Create session
hive create --tool pi --path /projects/myapp --name my-session

# Attach to session
hive attach my-session

# Delete session
hive delete my-session

Aliases:

• list / ls
• create / new
• attach / a
• delete / rm

JSON Output Example:

[
  {
    "name": "hive-abc123",
    "tool": "pi",
    "path": "/projects/myapp",
    "status": "running"
  }
]

Configuration

Config file: ~/.config/hive/config.json

{
  "theme": "tokyo-night"
}

Themes

Press t to cycle through themes:

• Tokyo Night (default)
• Tokyo Storm
• Dracula
• Nord
• Gruvbox
• Catppuccin
• One Dark
• Solarized Dark
• GitHub Dark
• Rose Pine
• Monokai
• Zinc Dark

Debug Mode

DEBUG=1 hive

Logs are written to debug.log.

Project Structure

hive/
  main.go
  internal/
    cli/          # CLI commands
    components/   # UI components
    config/       # Configuration
    logger/       # Logging
    session/      # Session types
    styles/       # Themes & styles
    tmux/         # tmux operations
    tui/          # TUI logic
  assets/         # Demo GIF

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing)
5. Open a Pull Request

License

MIT License - see LICENSE for details.