OpenReef

Agent teams, packaged

The open standard for multi-agent formations. Define agents, wire communication, schedule tasks, and deploy to any compatible platform*. One manifest, any runtime.

*Starting with OpenClaw

Quick Start

terminal
# Install the CLI
$ npm install -g @openreef/cli
# Scaffold a new formation
$ reef init my-team
# Validate and deploy
$ reef validate ./my-team
$ reef install ./my-team
✓ Formation "my-team" deployed successfully

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

How It Works

1

Define

Declare your agents, communication topology, skills, variables, and cron jobs in a single reef.json manifest.

2

Package

Bundle the manifest with agent personalities (SOUL.md), knowledge files, and config into a portable .reef.tar.gz.

3

Deploy

Run reef install and the CLI provisions everything on your target platform. Agents, bindings, schedules, and all.

Featured Formation

shoal

daily-ops

Founder's Daily Operations Squad

A 5-agent team that handles your daily operations. Email triage every 5 minutes. Morning briefing at 7am. Research on demand. Content drafts in your voice. You focus on strategy. Your agents handle the rest.

Chief of Staff Orchestrator
Inbox Manager Every 5min
🔍
Research Analyst On demand
Content Writer Daily + on demand
Daily Briefing 7am daily
$ reef install daily-ops \
--var FOUNDER_NAME="Ada" \
--var BUSINESS_NAME="Lovelace Labs"

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. {{FOUNDER_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

solo

Single Agent

One focused agent with personality, skills, and scheduling. Perfect for a dedicated assistant or specialist.

school

6+ Agents

Large-scale or dynamically-spawning agent patterns. For complex operations that need many specialized roles.

Build & Share

Build agent teams that others can deploy. Package your formation with reef pack, share it as a tarball or publish to the registry. Supply-chain integrity built in with reef.lock.json and SHA-256 digests.

Semantic Versioning Lockfile Pinning No Code Execution JSON + Markdown Only Pre-install Audit SHA-256 Integrity