VOLY —
a flock of agents

Control plane for AI coding agents: multi-agent orchestration, plan gates, write-safety (dry-run & protected paths), a billing fallback chain, and cost control. Run open-core locally — or team cloud at cloud.voly.codes.

9+
model providers
7
executors
5
roles in the flock
$0
re-run on cache hit

Orchestration

A lead orchestrator splits the task into roles and assigns each a model and skills. Implement roles write files; review stays on chat.

Plan gates

Steps only advance after verification — files, git, or tests. Not “the model said it was done.”

Safety

File writes are guarded: dry-run with diff preview, protected paths, max-files limit, git-based rollback.

Fallback

Billing fallback chain: claude-code → wrangler → opencode → zen. Out of credits — the task doesn't fail.

Telemetry & BYOK

Tokens, cost, and cache hits per run. Spend limits, cost policy — and provider keys in Cloudflare Secrets Store.

Open core + Cloud

Apache 2.0 core on your laptop. Team cloud is live: orgs, invites, shared run history, hosted runs, spend — features stay open, hosting is paid.

How a task flies

One entry point — CLI, Web UI, or CI. From there, the route depends on task complexity.

voly run "implement auth refactor" --cwd /path/to/project
complex · ≥2 capabilities

Multi-agent · hybrid A2A

The lead assigns tiers and skills. Implement roles write files via executors; review stays on chat. Results and cost flow into one run report.

simple code task

Executor · fallback chain

claude-code Anthropic ✗ billing
wrangler Workers AI ✗ billing
opencode free models ✗ billing
zen free ✓ running

Out of billing — the next executor in the chain picks up the task. Every one of them writes files into --cwd. Use --dry-run to preview writes safely.

AIGateway.chat() the only exit to models
DLP Cache Rate limit Spend limit BYOK Provider Telemetry

Local run report & team cloud

Open-core Web UI: every run opens into a report — safety badges, hybrid role summary, touched files, dry-run diffs, tokens and cost. For the whole team: cloud.voly.codes shows shared org history, spend today, and hosted “Run in cloud”.

VOLY Web UI: run report with safety badges, files, cost, and multi-agent roles
Local Web UI run report. Team surface: https://cloud.voly.codes — orgs, invites, local+hosted runs, spend.

Executors

Who runs the task and what happens when billing runs out.

VOLY compresses providers and agents into one control plane
One press for all: providers and agents under VOLY's control.
ExecutorWrites filesBillingIn the chain
claude-codeyesAnthropic1st
wrangleryesCF Workers AI2nd
opencodeyesfree models → your own keys3rd
zenyesfree4th (last resort)
cursoryesCursorstandalone
deepseek / mimono — text onlyAPIoutside the chain

Savings you can see

VOLY counts every token: caching, routing, and fallback turn into concrete numbers, not gut feelings.

Billing fallback chain: paid → free, the task never stops
voly savings
spent today $4.20 / $20.00 limit
cache hits 62% → saved $6.85
model routing premium → cheap: $3.10
task re-runs 8 tasks from cache: $0.00
total this week saved $41.70

* example output — numbers depend on your tasks

Quick start

A full control plane running locally in a couple of minutes. Python 3.10+. Keys via .env or BYOK in Cloudflare Secrets Store.

git clone https://github.com/voly-codes/voly.git && cd voly
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[ui,dev]"
voly init && voly ui
voly run "fix a bug" --cwd ~/my-project --dry-run
# local dashboard at localhost:7788 — team cloud at cloud.voly.codes

Higher together

Build and run agents open-core on your machine — or invite the team on cloud.voly.codes.