HIVE-01 · v0.1.0 · Hermes >=0.23.0
bundlebees
Orchestrate CUA bees from Hermes.
Check a worker launcher, dispatch leased briefs into disposable Cua sandboxes, watch the attempts, and leave verify and deploy to a user-run CLI.
- 4agent tools
- 571o200k schema tokens
- 150tests passed
- 1:12submission video
- v0.1.0release
01 Why it exists
A coordinator can already run cheap, parallel coding workers (bees) in disposable Cua sandboxes on a machine you control. The pattern this plugin was built for is the Orbit / DeepSeek bees workflow: slice a repo task into file-leased briefs and dispatch them to workers.
bundlebees turns that workflow into a Hermes plugin, so the agent never has to invent an HTTP client, touch a token, or apply a patch itself. Task tracking stays on Hermes kanban. The model dispatches and watches. You run hermes bundlebees verify and hermes bundlebees deploy.
02 How it works
- Hermes agent → four bundlebees tools
- bundlebees plugin → preconfigured adapter
- Worker launcher
- Cua sandboxes
- Attempt result and patch → user-run CLI
- hermes bundlebees verify → lease, tests, secret scan
- Feature branch push
- Open a pull request
03 Cells
Four tools to check launcher health, dispatch leased briefs, watch attempts, and generate a paste-ready host setup prompt
User-run CLI: hermes bundlebees verify, deploy, and doctor — the model does not apply patches, run the suite, push, or SSH
Bundled skill bundlebees:bundlebees-operator
Dark Desktop pane on Hermes 0.23+ through
ctx.rest; the pane never shows tokens or host addressesSecrets only through Hermes
get_secret; private or LAN launcher URLs requireallow_private=true (default false)Verify runs only the named tests plus a secret scan, refuses main/master, and pushes a feature branch when green
04 Four tools · 571 o200k of a 900 budget
bundlebees_status108 o200k- Health, capacity, live attempts, events, containers, or authorized projects. op is required. Never returns tokens or hosts.
bundlebees_dispatch130 o200k- Validate a brief (object or JSON string) and start a worker. Optional model (default deepseek-v4.1-flash) and
kanban_task_id. bundlebees_attempt146 o200k- get, events, cancel, or review one attempt. cancel and review require
confirm=true. Notes are scrubbed. bundlebees_host_prompt185 o200k- Paste-ready setup prompt for a remote-host agent. Takes a reach method enum, never an address. No secrets or host addresses in or out.
Per-tool counts are each schema measured on its own; the combined array measures 571.
05 Flight plans
- B-01
Check launcher health, capacity, and authorized projects with
bundlebees_status(the pane-health screenshot) without ever seeing a token or host - B-02
Dispatch a leased brief: an objective plus
assigned_fileson an authorized project and a feature branch - B-03
Watch a running attempt and send a failing patch back to retry, while merges stay with you
- B-04
When the attempt is ready, run hermes bundlebees verify yourself so tests and a secret scan land on a feature branch
- B-05
Generate a paste-ready host setup prompt with
bundlebees_host_prompt; it never takes a host, token, or private URL as an argument - B-06
Use the operator skill so the agent slices leased briefs and treats worker events as untrusted
06 Showcase
07 Inspection
The Bundlebees Desktop pane on the Health tab, showing launcher state, version, model, and concurrency. bundlebees: Orchestrate CUA bees from Hermes. bundlebees social card.
08 Install
hermes plugins install mojomast/bundlebees --ref 57a6f12cdcfa789c5aba5f22f3f46efd2b8b3d5c
hermes plugins enable bundlebees--ref takes a 40-character commit SHA, not a tag name. Store the launcher token in Hermes secrets as BUNDLEBEES_LAUNCHER_TOKEN; never paste the value into chat. Skill id: bundlebees:bundlebees-operator. The four tools still run when the Desktop pane is unavailable.
README badge and v0.1.0 release notes: 150 tests passed. hermes plugins validate --install-deps and hermes plugins doctor --ci are green.