Connect Linear

Connecting Linear lets the team’s thinking, or one group’s, learn from the issues and comments in the Linear teams you choose, including how work turned out. Only a team’s owners and admins can set it up, and only in a team workspace.

Set it up

1. In Cranes, open Settings › Sources and choose Connect Linear.
2. Fill in:
   • Linear teams: each team’s key, separated by commas. It’s the prefix on its issue IDs, like ENG in ENG-123.
   • What it feeds: the team’s thinking, or a group you’re in.
3. Choose Continue to Linear, and approve read access in Linear. Your Linear account needs to be able to see those teams.
4. Linear sends you back to Settings › Sources.

Cranes reads the last 30 days of issues straight away, then changes about every 15 minutes.

What becomes an entry

• Each issue becomes one entry: its ID, title, status, and description. When the issue changes, including when it’s reopened, finished, or cancelled, the newer version replaces the older one, so the thinking learns how work turned out.
• Each comment becomes its own entry, credited to its author’s Linear name.

Issues are learned in the next pass, not one at a time, and a single issue never becomes the team’s position on its own. Everyone who can read the thinking it feeds can see these entries, so connect a group only when its members may see those Linear teams.

Disconnect

Only owners and admins see Revoke. It stops reading. Entries already brought in stay, with their usual entry settings.