Publish a Formation

Share your multi-agent formations with the OpenReef community. Publishing takes just a few steps.

1

Create a formation

Initialize a new formation project in your working directory. This creates a reef.json manifest file with your formation's configuration.

$ reef init my-formation

Edit reef.json to define your agents, connections, and configuration:

{
  "name": "my-formation",
  "version": "1.0.0",
  "description": "A multi-agent workflow for...",
  "type": "shoal",
  "license": "MIT",
  "agents": [
    {
      "name": "planner",
      "model": "claude-sonnet",
      "role": "Plans and coordinates tasks"
    },
    {
      "name": "executor",
      "model": "claude-haiku",
      "role": "Executes planned tasks"
    }
  ],
  "agentToAgent": [
    { "from": "planner", "to": "executor", "channel": "tasks" }
  ]
}
2

Get an API token

You need an API token to authenticate with the Tide registry. Generate one from your Dashboard.

Important: Your token is only shown once when generated. Copy it immediately and store it securely.
3

Set your token

Set the REEF_TOKEN environment variable with your API token:

$ export REEF_TOKEN=reef_tok_your_token_here

You can also add this to your shell profile (~/.bashrc, ~/.zshrc) for persistence.

4

Publish

Run the publish command from your formation's directory:

$ reef publish .

This will package your formation, upload it to the Tide registry, and make it available for others to install.

After publishing

Once published, your formation will be available for anyone to install:

$ reef install my-formation

You can view and manage your published formations from your Dashboard. To publish a new version, update the version field in reef.json and run reef publish . again.