Skip to content

rdfitted/hive-manager

Repository files navigation

Hive Manager

A desktop application for orchestrating multi-agent AI coding sessions. Launch coordinated teams of AI coding assistants (Claude, Codex, Gemini, Antigravity, etc.) that work together on complex software tasks.

Hive Manager Platform License

Hive Manager Screenshot

Features

  • Hive Mode: Queen + Workers architecture for coordinated development
  • Swarm Mode: Hierarchical planners with domain-specific mini-hives
  • Fusion Mode: Parallel competing implementations with best-pick resolution
  • Session Persistence: Save and resume sessions across app restarts
  • Multi-CLI Support: Works with Claude Code, Codex, OpenCode, Gemini CLI, Antigravity CLI (agy), and more
  • Real-time Monitoring: Watch all agents work simultaneously with live terminal output
  • Git Integration: Automatic branch management and coordination

Installation

Windows

Download the latest release from the Releases page:

  • NSIS Installer: Hive Manager_x.x.x_x64-setup.exe (recommended)
  • MSI Installer: Hive Manager_x.x.x_x64_en-US.msi

Build from Source

Requirements:

  • Node.js 18+
  • Rust 1.70+
  • Windows 10/11
# Clone the repository
git clone https://github.com/rdfitted/hive-manager.git
cd hive-manager

# Install dependencies
npm install

# Development mode
npm run tauri dev

# Production build
npm run tauri build

Quick Start

  1. Launch Hive Manager
  2. Click New Session in the sidebar
  3. Select your project directory
  4. Choose a session type (Hive, Swarm, or Fusion)
  5. Configure your agents (CLI, model, roles)
  6. Click Launch

Session Types

Hive

Traditional Queen + Workers setup. The Queen coordinates and delegates tasks to specialized Workers.

Swarm

Hierarchical architecture with Planners that each manage their own mini-hive of Workers. Great for large, multi-domain projects.

Fusion

Launch multiple agents working on the same task in parallel. Compare approaches and pick the best solution.

Supported CLIs

CLI Behavior Notes
Claude Code Action-Prone Anthropic's official CLI. Needs role hardening for worker agents.
Antigravity CLI Action-Prone Google's agy (successor to Gemini CLI). Default for the frontend role in Hive worker mode. Model + verbosity live in ~/.gemini/antigravity-cli/settings.json — no --model flag. After installing agy, restart Hive Manager so the spawn environment picks up the new User PATH entry. ⚠️ Known upstream issue google-antigravity/antigravity-cli#76agy -p silently drops stdout in non-TTY contexts; affects Solo-mode antigravity launches only. Hive worker mode is unaffected.
Gemini CLI Action-Prone Google's legacy CLI. Selectable but deprecates 2026-06-18; prefer Antigravity for new work.
Codex Explicit-Polling OpenAI's CLI. Uses bash loops for coordination.
OpenCode Explicit-Polling Open-source alternative.
Qwen Instruction-Following Follows instructions literally, respects role boundaries naturally.
Droid Interactive TUI mode with /model command for model selection.
Cursor Interactive Runs via WSL. Uses global model setting.

Behavior profiles determine how Hive Manager prompts each agent:

  • Action-Prone: Proactive agents that need strong constraints to stay in their lane
  • Instruction-Following: Literal interpreters that respect role boundaries naturally
  • Explicit-Polling: Agents that need bash loops for coordination
  • Interactive: TUI-based agents with different prompt injection

Configuration

Sessions are stored in %APPDATA%/hive-manager/sessions/.

App configuration is in %APPDATA%/hive-manager/config.json.

Development

# Run in development mode with hot reload
npm run tauri dev

# Type checking
npm run check

# Build for production
npm run tauri build

Tech Stack

  • Frontend: SvelteKit 5, TypeScript
  • Backend: Rust, Tauri 2
  • Terminal: xterm.js with PTY support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

Acknowledgments

Built with Tauri, SvelteKit, and xterm.js.

Sponsor this project

Packages

 
 
 

Contributors