Skip to content

Plane advanced and reference

This page collects deeper material and links out to the canonical Cinatra chapters — it does not duplicate them.

The Plane integration is one provider behind Cinatra’s provider-neutral PM connector contract. Cinatra defines a single connector shape — “mirror this trigger to a work item”, “delete this work item”, “read back the trigger” — and a provider registry the host resolves at runtime. Plane is the provider today; the contract is deliberately neutral so other tools can be added later without changing how scheduling works in Cinatra.

For the cross-cutting platform reference, see the canonical References chapter, and for the user-facing scheduling story see the Guides.

  • Dates are day-level and sent as YYYY-MM-DD.
  • The connector sends a start date and a target date derived from when the trigger is due. It never sends due_date — Plane silently drops it, so the target date carries the due semantics instead.

The connector exposes these primitives over MCP for inspection and diagnostics:

  • plane_status — probe the configured connection’s health.
  • plane_instances_list — list configured Plane instances.
  • plane_projects_list — list the projects the configured token can reach.
  • Plane: self-hosted Plane CE, verified against v1.3.1. Authentication is the X-API-Key header alone. Tokens are minted under Profile → API Tokens and begin with plane_api_.
  • Cinatra: see the cinatraCompat range in this page’s footer for the supported Cinatra version range.

Docs content licensed under CC-BY-4.0; embedded code snippets under Apache-2.0.