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, 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, 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.
Gemini CLI Action-Prone Google's CLI. Similar behavior to Claude.
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

No packages published

Contributors 3

  •  
  •  
  •