intent

you file the intent.
machines do the work.

rosary is an autonomous work orchestrator. you describe what needs to happen — as beads, small enough for a machine to hold. agents pick them up, one by one, in isolated worktrees. they build. they test. they surface PRs. you review what survives.

01 — scan

find ready beads

every cycle, rosary scans your registered repos for open beads. beads are units of work — small enough for a machine to complete in one session. "fix auth bug." "add retry logic." "write the migration."

◊

multi-repo

register any repo. rosary watches them all. file-level overlap detection prevents two agents from touching the same code at once.

○

dolt-backed

beads live in your repo as version-controlled SQL. branch, diff, merge your work queue like code.

02 — triage

rank + assign

score by priority. check thread sequencing — same-thread beads wait their turn. filter blocked dependencies. respect per-repo concurrency limits. the highest-priority bead surfaces.

Δ

thread-aware

beads organize into threads (sequences) and decades (chapters). the rosary is the structure.

03 — dispatch

agent gets a worktree

an agent is assigned. it gets an isolated git worktree — clean room. the prompt is built from the bead description, file scopes, and the handoff chain from previous phases. the agent begins.

○

any model

claude, gemini, or your own agent definitions. rosary doesn't care what runs — it cares that the tests pass.

Δ

isolated

each agent gets its own worktree. if the work fails, the worktree vanishes. your main branch never knows.

04 — verify

build, test, lint

five verification tiers. commit exists? compile? tests pass? lint clean? diff sane (≤10 files, ≤500 lines)? first failure short-circuits. three strikes → deadletter to you.

05 — close

you review
what survives

the human reviews 5 PRs a day. the agents handle the atoms. you hold the intent. the machines hold the implementation. rosary is the thread between.

the loop never stops unless you tell it to. ↑

protocol

speaks MCP
natively

20+ tools over streamable HTTP. connect claude code, connect your own agents, or hit the hosted endpoint. rosary doesn't have a UI — it has a protocol.

your agents connect here

bead CRUD. dispatch control. pipeline queries. workspace management. thread + decade organization. all as MCP tool calls.

mcp.rosary.bot live
# ── hosted (one command) ──
claude mcp add --transport http \
  rosary https://rosary.bot

# ── local (self-hosted) ──
rsry serve --transport http
claude mcp add --transport http \
  rosary http://localhost:8080/mcp
begin

open source.
always.

register your repos. write some beads. let the loop take over.