# Hive

> Turn a rough idea into a merge-ready pull request — a multi-agent pipeline you watch as it works and can step into at any stage.

Hive is an open-source (MIT) command-line tool that turns a rough idea into a merge-ready pull request through a multi-agent pipeline (brainstorm → plan → execute → review → finalize) you watch and can step into. Each page below is also available as raw markdown.

## Docs

- [Getting started](https://hivecli.sh/docs/getting-started.md): Install Hive, attach it to a project with hive init, and run your first task in the TUI.
- [Concepts](https://hivecli.sh/docs/concepts.md): The three load-bearing ideas behind Hive — folder-as-agent, the nine stages, and the marker protocol.
- [Configuration](https://hivecli.sh/docs/configuration.md): Project config, patrol mode, reviewers, agent profiles, the daemon, and token-cost knobs.
- [Operating](https://hivecli.sh/docs/operating.md): Run the daemon, Telegram bot, and babysitter as services, and drive Hive from OpenClaw.

## Command reference

- [hive init](https://hivecli.sh/docs/commands/init.md): Bootstrap a git project for Hive — creates the state branch, scaffolds stages, and walks you through setup.
- [hive new](https://hivecli.sh/docs/commands/new.md): Capture a new idea into a Hive project's inbox so you can move it through the pipeline.
- [hive tui](https://hivecli.sh/docs/commands/tui.md): The interactive two-pane dashboard for watching tasks and driving every workflow verb with a keystroke.
- [hive status](https://hivecli.sh/docs/commands/status.md): Show the live state and next useful action for every task across your registered projects.
- [hive run](https://hivecli.sh/docs/commands/run.md): The low-level dispatcher that executes whatever stage a task is currently in.
- [hive approve](https://hivecli.sh/docs/commands/approve.md): Advance a task to the next stage with marker checks, locking, and an atomic move-and-commit.
- [hive findings](https://hivecli.sh/docs/commands/findings.md): List and toggle the reviewer's findings so accepted ones feed the next implementation pass.
- [hive patrol](https://hivecli.sh/docs/commands/patrol.md): Opt-in repository scan that finds, fixes, validates, and opens PRs for issues across a registered project.
- [hive babysit](https://hivecli.sh/docs/commands/babysit.md): Experimental background process that keeps open PRs green, mergeable, and rebased behind main.
- [hive daemon](https://hivecli.sh/docs/commands/daemon.md): The always-on dispatcher that auto-advances ready tasks through every workflow stage.
- [hive bot](https://hivecli.sh/docs/commands/bot.md): Telegram bot for approving, answering, and capturing ideas from your phone.
- [hive doctor](https://hivecli.sh/docs/commands/doctor.md): Preflight check that verifies your configured stage and reviewer skills are actually installed.
- [hive metrics](https://hivecli.sh/docs/commands/metrics.md): Report how often Hive fix-agent commits get reverted, optionally scoped by project and time window.
- [hive update](https://hivecli.sh/docs/commands/update.md): Update Hive using the same channel that installed it — Homebrew, the AUR helper, or the install script.
- [hive uninstall](https://hivecli.sh/docs/commands/uninstall.md): Remove Hive's services, config, cache, and symlinks while preserving your accumulated work by default.
- [hive drop](https://hivecli.sh/docs/commands/drop.md): Permanently delete an active task — its worktree, branch, stage folders, and logs. There is no undo.
- [hive migrate](https://hivecli.sh/docs/commands/migrate.md): Upgrade a project's tasks and config to the current Hive stage layout. Safe to re-run.
- [hive wiki](https://hivecli.sh/docs/commands/wiki.md): Rebuild a project's wiki/log.md changelog from per-change fragments, or check whether it's stale.

## Optional

- [Full documentation in one file](https://hivecli.sh/llms-full.txt): every page concatenated
- [Source on GitHub](https://github.com/ivankuznetsov/hive)