mellona-hive 2.3.2

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.

Keep your agent. Add a control plane.

mellona-hive is the distribution you install from PyPI or Homebrew. Mellona is the package family. Agent Hive is the current product. Install with the [console] extra to get the live operator UI alongside the hive CLI.

Install

Pick the installer you already trust:

uv tool install 'mellona-hive[console]'

pipx install 'mellona-hive[console]'

python -m pip install 'mellona-hive[console]'

Then verify:

hive --version
hive doctor

CLI-only install: For headless servers or CI, uv tool install mellona-hive gives you the base CLI without console dependencies.

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

Additional extras (mellona-hive[mcp], mellona-hive[sandbox-e2b], mellona-hive[sandbox-daytona]):

• MCP adapter: uv tool install --upgrade 'mellona-hive[console,mcp]'
• Hosted E2B sandbox: uv tool install --upgrade 'mellona-hive[console,sandbox-e2b]'
• Self-hosted Daytona sandbox: uv tool install --upgrade 'mellona-hive[console,sandbox-daytona]'
• Homebrew: brew install intertwine/tap/mellona-hive (base CLI only, add extras through pip/uv/pipx)

If you install sandbox extras, verify the current machine with hive sandbox doctor --json.

First Run

Start in an empty directory:

mkdir my-hive
cd my-hive
git init
hive onboard demo --prompt "Create a small React website about bees."
hive console serve

Open http://127.0.0.1:8787/console/ to see your workspace in the operator console. Then use the manager loop:

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

Governed edits happen inside the run worktree that hive work creates, not in the workspace root.

Fresh onboarded projects 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.

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