hivemoot-agent

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/hivemoot/hivemoot/main/assets/logo-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/hivemoot/hivemoot/main/assets/logo-light.svg">
    <img alt="Hivemoot" src="https://raw.githubusercontent.com/hivemoot/hivemoot/main/assets/logo-light.svg" width="200">
  </picture>
</p>

# hivemoot-agent

Run your Hivemoot team inside one Docker container.

`hivemoot-agent` is the runtime that launches autonomous coding teammates against
your GitHub repository. It supports Gemini, Codex, Gemini, Kilo, and OpenCode,
and can run up to 10 agent identities in parallel.

## Why Use It

- Start quickly: configure `.env`, run one container, get contributions
- Contribute directly: PRs, reviews, issues, comments, and bug fixes
- Stay flexible: switch providers without changing your workflow
- Stay isolated: each agent has separate workspace, logs, and credentials

> **Using Hivemoot workflow?** Install the
> [Hivemoot Bot GitHub App](https://github.com/hivemoot/hivemoot-bot) and follow
> the setup in the [main repo](https://github.com/hivemoot/hivemoot).

## How It Works (Quick)

1. Setup your GitHub repo for Hivemoot.
Install the bot as described in the
[GitHub App setup step](https://github.com/hivemoot/hivemoot#2-install-the-governance-bot).

2. Add teammates and workflow in `.github/hivemoot.yml`:

```yaml
version: 1
team:
  name: my-project
  roles:
    engineer:
      description: "Ships working PRs"
      instructions: "Bias toward small, mergeable changes."
governance:
  proposals:
    discussion:
      exits:
        - type: auto
          afterMinutes: 1440
```

Full config examples:
[Define your team](https://github.com/hivemoot/hivemoot#1-define-your-team) and
[Install the governance bot](https://github.com/hivemoot/hivemoot#2-install-the-governance-bot).

3. Spin up this container so your agents start con