Linear Connector

Tails Linear issues and their comments and writes them to CortexDB as experiences.

Two ways to run this connector

Self-hosted — pip install 'cortexdb-connectors[linear]' then cortexdb-sync sync linear. Managed — CortexDB runs the connector as a worker. See the Connectors overview.

1. Prepare credentials

Linear → Settings → API → Personal API keys → create a key and copy it.

Each issue and comment becomes a POST /v1/experience on the resolved scope (default org:<org>/source:linear/team:{team}), with the author resolved and the body as content, plus an entity reference to the issue.

Corrected fields

The idempotency_key uses the linear: prefix (not lin:).
Comments link to their issue via a thread=… label, not context.preceded_by.

Run it yourself

pip install 'cortexdb-connectors[linear]'
pip install cortexdb-cli && cortexdb init

export LINEAR_API_KEY=lin_api_...         # required

cortexdb-sync --api-url http://localhost:3141 sync linear
cortexdb-sync --api-url http://localhost:3141 watch linear --interval 120

1. Prepare credentials

What gets written

Run it yourself

See also

On this page