Summary

Hive provides a browser-native orchestration layer for managing multiple command-line coding agents (Claude, Codex, Gemini, OpenCode). It enables collaboration via distinct PTY processes, streamlining task delegation, progress tracking, and session management for AI-assisted workflows.

How It Works

Hive's browser UI communicates via HTTP/WebSocket to a local runtime managing agent PTY processes, task dispatching, and SQLite metadata. Agents (Orchestrator/Workers) use an injected "team protocol" and share a Markdown task graph (<workspace>/.hive/tasks.md). This treats agents as genuine terminal processes, integrating seamlessly with existing CLIs.

Quick Start & Requirements

• Primary install: npm install -g @tt-a1i/hive
• Prerequisites: Node.js 22+, supported Agent CLI installed/logged in (PATH). Native build tools may be needed for package installation.
• Run: hive (UI typically at http://127.0.0.1:3000/). Demo mode available.
• Docs: hivehq.dev

Highlighted Details

• Agents run as real PTY processes managed by the runtime.
• Shared Markdown task graph (<workspace>/.hive/tasks.md).
• Workspace sidebar, pre-defined roles (coder, reviewer, tester), or custom configurations.
• Attempts native agent session recovery.

Maintenance & Community

• Alpha stage, focusing on collaboration, Windows support, observability.
• Roadmap: Cross-agent long-term memory via EverOS.
• Alternative: squad project for pure CLI/SSH workflows.
• Includes community prompt libraries (MIT license).

Licensing & Compatibility

• License: Business Source License 1.1 (BSL 1.1). Allows personal/internal use, forking; commercial restrictions apply (see LICENSE.BSL).
• Trademark restrictions apply as per TRADEMARK.md.

Limitations & Caveats

• Local tool: no sandboxing, multi-user auth, or cloud hosting.
• Workers inherit shell permissions; only open trusted workspaces.
• PWA install limited to Chromium browsers.
• Directory selection may require system tools (zenity on Linux, powershell.exe on Windows).