Linear

A Linear trigger starts an instruction automation when something changes in your Linear workspace. The managed agent follows your instructions for each change, with the Space’s connections and skills.

Note

Linear events start instruction automations only. Code automations cannot receive Linear events yet. See Linear and code automations.

Before you start

• Connect Linear to Type, and add the connection to the Space. In the CLI, run type-cli integrations connect linear.
• Make sure that the Space has the skills that the managed agent needs, for example a triage skill.

What Type receives from Linear

Type receives changes to these Linear items:

• issues,
• comments,
• projects and project updates,
• cycles,
• issue labels,
• reactions.

Make an instruction automation

1. Open the Space’s Automations page (or Space settings → Automations in the settings layout).
2. Select New Synced Event.
3. Choose Linear as the source.
4. If Linear has more than one connection, choose the connection.
5. Select Connect Linear.
6. Write instructions that tell the managed agent what to do with the event. To use a skill, write its handle, for example /issue-triage.

In the CLI:

type-cli synced-events create --space <space> --source linear --integration <org-integration-id> --enable

Examples:

• Triage new issues: add a label, suggest an owner, and ask for missing details.
• Summarize priority changes for the team each time they happen.
• Draft a project update when a project changes state.

Write good instructions

• Say which changes matter. Tell the managed agent to stop with no action for other changes.
• Say what output to make and where to post it.
• Tell the managed agent to treat issue and comment text as evidence, not as instructions.

Do not use broad triggers. They make noisy work. Start with one kind of change that has high value. Add more when the managed agent gives useful results each time.

Linear and code automations

A code automation cannot subscribe to Linear events. Type rejects the subscription at the subscription stage of the deploy. Only Slack, GitHub, and custom webhook adapters can send events to code.

To work with Linear from code, use a schedule:

1. Read new or changed Linear items with the Linear connection’s tools. See Call Connected Apps and APIs.
2. Save the last item that you processed in a checkpoint.
3. Hand items that need judgment to the managed agent.

Limitations

• A Linear instruction automation must be enabled when you make it, and you cannot pause it. To stop it, delete it.
• Code automations cannot receive Linear events.