Plane
Plane is the first external board adapter. Nexus keeps its own authoritative
board and projects to Plane via the PlaneBoardProvider (nexus-board-plane).
What the adapter does
- Create Plane work items from Nexus board items
- Update Plane states as Nexus statuses change
- Add comments (agent progress, handoffs)
- Receive Plane webhooks and reconcile external changes
Status mapping
| Nexus status | Plane state |
|---|---|
planned | Backlog |
ready_for_agent | Ready for Agent |
running | In Progress |
waiting_human | Need Human Review |
blocked | Blocked |
done | Done |
Rate limits
Plane's REST API is documented at ~60 requests per minute per API key. The
adapter applies client-side rate limiting (governor) and backoff so bursts of
board updates never trip the limit.
Webhooks
Plane supports webhooks for project / work-item events. Nexus verifies webhook
payloads with HMAC (hmac + sha2), then the worker reconciles the change into
the internal board (board_links maps internal ↔ external IDs).
Config
Stored in the integrations collection:
{
"_id": "integration_plane",
"type": "plane",
"base_url": "https://plane.example.com/api/v1",
"workspace_slug": "nexus",
"project_id": "...",
"api_key_ref": "secret://plane-api-key",
"webhook_secret_ref": "secret://plane-webhook-secret"
}