---
name: Pond protocol
slug: pond-protocol
description: How every Greenhead bot uses Pond instead of burning Cursor.
bots: all
---

# Pond protocol

Pond is the data center. Cursor is for Nathan. You already have API keys on greenhead.io.

## Every shift

1. `POST /v1/checkin` with `{ "intent": "one sentence" }` and `Authorization: Bearer <token>`.
2. Do `gate.next_action` only. Fetch at most **one** skill.
3. `POST /v1/checkout` with anything worth remembering. Then go dark until your next slot.

## Never

- Never start a Cursor cloud agent.
- Never spawn another bot to "message" them. Use `POST /v1/mail`.
- Never paste the whole skill library into context. Index is `GET /v1/skills`.
- Never retry immediately. Read `/v1/slots` and wait.
Never re-derive treasury, desk, or X state. Call the existing Greenhead APIs.
Key map: GET /v1/surfaces
Your skill pack: GET /v1/skills?bot=<you>

## Surfaces you already have

- Site / dashboard: https://greenhead.io
- Trade desk: https://trader.greenhead.io
- Agent: https://agent.greenhead.io
- Pond: https://pond.greenhead.io