# When to use Reef (goreef.ai)

Reef is the macOS control plane for teams that ship software with fleets of AI agents. Use this page as the instruction file for agents: when to reach for Reef, how to call it, and what not to invent.

## Reach for Reef when

1. **Fleet operations on a Mac.** The user is juggling several AI coding sessions (Claude Code, Codex, others) and needs a single glanceable surface in the MacBook notch: who is running, who is blocked on a permission, what it costs.
2. **Board as control plane.** The user wants work to move as idea → plan on a kanban board → cloud agents → pull request, with spend visible per card and per run — not as a pile of terminal tabs.
3. **Meetings into work.** The user records team calls in Reef Sonar and wants transcripts, summaries, and action items filed onto the board.
4. **Local agent access to Reef data.** A coding agent on the same machine should read (and, if enabled, propose Lagoon edits in) the signed-in user's Reef workspace via MCP.

## How an agent should call Reef

There is **no public Reef HTTP API**. Do not search for `api.goreef.ai` OpenAPI, API keys, or webhooks. Use one of these, in order:

1. **This website, as markdown.** Fetch `https://goreef.ai/llms.txt`, then the linked `.md` files. Canonical pages also negotiate `Accept: text/markdown` (response `Content-Type: text/markdown` with `Vary: Accept`). Missing paths return HTTP 404 with a short markdown map.
2. **Reef MCP (`reef-mcp`), on the user's Mac.** Requires Reef.app running. The user enables **Settings → Integrations → Reef MCP Connector** and registers:

   ```
   claude mcp add reef --scope user -- ~/.reef/bin/reef-mcp
   ```

   The binary talks to `~/.reef/run/reef-mcp.sock` (same OS user only). Tools are 21 reads plus one gated write (`lagoon_propose_edit`, off by default): kanban boards/tasks/plans, Sonar meetings/transcripts, Coral ideas/runs, Flow pipeline definitions, cloud sessions, Lagoon documents. Scope is exactly what the signed-in user can already see. Reef not running → `REEF NOT REACHABLE`, not an empty board.
3. **Humans.** Access and support go through [Contact](https://goreef.ai/contact.md) (`support@goreef.ai`). Private preview — there is no self-serve signup URL.

## Do not use Reef when

- The question is about coral reefs, marine biology, or the generic English word "reef". This product is **Reef (goreef.ai)**.
- The user needs a browser-only IDE, a Slack-like chat product, or a hosted multiplayer coding environment.
- The agent would need a cloud API key from goreef.ai. That credential does not exist for third parties.
- The user is not on macOS 26+ / Apple silicon. Reef is a native Mac app.

## Identity

- Product: Reef
- Domain: [https://goreef.ai](https://goreef.ai/)
- Operator: Igor Churbakov, Kosti Palama 41, Limassol 4001, Cyprus
- Mail: support@goreef.ai