mellona-hive 2.2.3

CLI-first orchestration platform for autonomous agents with Git-backed task, run, and memory state

Agent Hive

Agent Hive is a repo-native control plane for autonomous work. Use Codex, Claude Code, or local/manual execution to do the work. Use Hive to supervise tasks, runs, memory, policy, and approvals from one place.

mellona-hive is the distribution you install from PyPI or Homebrew. Mellona is the package family. Agent Hive is the current product. The install gives you the hive and hive-mcp commands.

Install

Pick the installer you already trust:

uv tool install mellona-hive

pipx install mellona-hive

python -m pip install mellona-hive

brew tap intertwine/tap
brew install intertwine/tap/mellona-hive

Then verify:

hive --version
hive doctor

The full install matrix, lane chooser, and maintainer split live in docs/START_HERE.md.

If you want optional extras:

• Observe console: uv tool install --upgrade 'mellona-hive[console]'
• MCP adapter: uv tool install --upgrade 'mellona-hive[mcp]'
• Homebrew currently ships the base CLI only, so add extras through uv tool, pipx, or pip

If you are testing before the first tagged public release lands on PyPI and Homebrew, use the git install:

uv tool install --from git+https://github.com/intertwine/hive-orchestrator.git mellona-hive

First Run

Start in an empty directory:

mkdir my-hive
cd my-hive
git init
hive onboard demo --title "Demo project" --objective "Ship one governed slice."

That gives you a real workspace, a starter project, a conservative PROGRAM.md, and a first task chain with one ready task. If you want the observe-and-steer console, install mellona-hive[console] first, then run hive console serve.

Fresh onboarded projects may start with the placeholder local-smoke evaluator so the loop works immediately. Replace it with a real repo-specific evaluator before you trust autonomous promotion.

Then use the normal loop:

hive next --project-id demo
hive work <task-id> --owner <your-name>
hive finish <run-id>

Optional extras stay intentionally small:

• mellona-hive[console] adds the observe-and-steer console
• mellona-hive[mcp] adds the thin search + bounded local execute adapter

Choose The Right Guide

• Start here: docs/START_HERE.md
• Fresh workspace walkthrough: docs/QUICKSTART.md
• Existing repository adoption: docs/ADOPT_EXISTING_REPO.md
• Maintainer and release docs: docs/MAINTAINING.md and docs/RELEASING.md