OpenReef
Agent teams as code
One manifest defines your agents, their personalities, communication topology, and schedules. One command deploys them. The package manager for multi-agent systems.
Send your bot one line to get started:
Read and install https://www.openreef.ai/ It will know how to:
Deterministic routing. No guessing. No unnecessary auth prompts.
Or, from your terminal:
What It Does
Without OpenReef
- Manually create each agent
- Write personality files one by one
- Wire inter-agent communication by hand
- Configure tools for each agent
- Set up cron jobs individually
- No way to share, reproduce, or version your setup
With OpenReef
$ reef install daily-ops 5 agents. Wired up. Scheduled. Running. In seconds.
- One declarative manifest
- Reproducible every time
- Shareable and versionable
- Safe - no code execution, just data
Formations in Action
Two real formations. Different architectures. Same install experience.
daily-ops
Daily Operations Squad
5 agents handle your daily operations. Email triage every 5 minutes. Morning briefing at 7am. Research and content on demand. You talk to the Chief of Staff — it coordinates the rest.
reef-forge
The formation that builds formations
Describe the agent team you need. The Architect coordinates four specialists through a structured pipeline: research, SOUL writing, scaffolding, and adversarial QA on a different vendor model for cognitive diversity.
How It Works
Define
Declare your agents, communication topology, skills, variables, and cron jobs in a single reef.json manifest.
Package
Bundle the manifest with agent personalities (SOUL.md), knowledge files, and config into a portable .reef.tar.gz.
Deploy
Run reef install and the CLI provisions everything on your target platform. Agents, bindings, schedules, and all.
What's In a Formation
reef.json
Declarative manifest. Agents, topology, skills, variables, cron. The single source of truth for your team.
SOUL.md
Each agent gets a personality file. Define behavior, tone, boundaries, and expertise with variable interpolation.
Communication
Wire agents together with agentToAgent adjacency lists. Hub-and-spoke, mesh, chain. Any topology.
Cron Jobs
Schedule agent wakeups. Heartbeat checks every 15 minutes, daily briefings at 7am, email triage every 5 minutes.
Knowledge
static/ for reference materials that update with the formation. dynamic/ for agent-written data that persists across updates.
Variables
Typed, validated configuration. Sensitive values never stored in plaintext. {{USER_NAME}} interpolates everywhere.
CLI Commands
Create
reef init my-team Scaffold a new formation from template
Validate
reef validate ./my-team Check schema and structural validity
Inspect
reef inspect ./my-team Preview what will be deployed
Install
reef install ./my-team Deploy the formation
Update
reef update ./my-team Update without losing agent data
Status
reef status my-team Check agent health and state
Scale Your Way
Single Agent
One focused agent with personality, skills, and scheduling. Perfect for a dedicated assistant or specialist.
2-5 Agents
A small coordinated team with defined roles and communication topology. The sweet spot for most workflows.
6+ Agents
Large-scale or dynamically-spawning agent patterns. For complex operations that need many specialized roles.