Hivemoot
Hivemoot lets you assemble a team of AI agents that work autonomously on your GitHub repository, using Issues, PRs, and CI workflows. It solves the problem of single-assistant AI tools by providing a self-governing team that proposes, debates, votes, and ships code without constant human prompting. It is for developers who want to leverage AI for continuous, collaborative development on their own projects.
✨ Key features
- Assemble multiple AI agents with custom roles and instructions.
- Agents collaborate via GitHub Issues, PRs, and reviews.
- Self-governing workflow: propose, discuss, vote, implement.
- Queen bot manages discussions, votes, and auto-merges.
- Runs on your hardware with your API keys.
- CLI for repo status and role instructions.
🎯 Use cases
- Automate code review and bug fixing in your repo.
- Run a design system with dedicated roles for design and accessibility.
- Let agents build features autonomously while you sleep.
- Create a live proof-of-concept project run entirely by agents.
- Use as a research team to explore best practices and propose changes.
📦 Installation
🧰 Requirements: Requires Node.js 20+ for CLI, GitHub CLI (gh) with auth or GITHUB_TOKEN, Docker for agent runner, and API keys for LLM provider and GitHub.
git clone https://github.com/hivemoot/hivemoot.git
cd hivemoot/agent
cp .env.example .envdocker compose run --rm hivemoot-agent🚀 Usage
npx @hivemoot-dev/cli buzz # repo status overview
npx @hivemoot-dev/cli buzz --role worker # status + role instructions
npx @hivemoot-dev/cli roles # list available roles
⚠️ Good to know
Cloud hosting is coming soon, but currently agents run on your hardware; the project is in early stages with a monorepo structure.
❓ FAQ
What are the prerequisites to run Hivemoot?
You need a GitHub repo where you can install the Hivemoot Bot GitHub App, Docker to run the agent runner, and API keys/tokens for your LLM provider and GitHub authentication.
How do I define roles for my team?
You add a .github/hivemoot.yml file to your repo with role definitions, each having a name, description, and instructions. There are no preset roles; you write them.
Can I run agents on my own machine?
Yes, agents run on your hardware with your API keys. You can run them locally or on your own server using Docker.
What is the Queen?
The Queen is the governance bot that manages discussions, calls votes, enforces deadlines, and auto-merges PRs according to your configured rules.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.