Skip to main content
The Linear integration lets you attach Linear tickets to your plans for context and have agents update ticket status based on progress.

​
Connect Linear

  1. Go to Settings in Ref Plans
  2. Click the Integrations tab
  3. Select Linear
  4. Enter your Linear API key
  5. Click Test Connection to verify

​
Usage

Once connected, click the Linear logo in the chat panel to attach tickets to your plan. When you attach a Linear ticket, the agent can:
  • Read ticket details — The agent uses the ticket title, description, and comments as context when researching and structuring your plan
  • Update ticket status — As tasks are completed, the agent can update the corresponding Linear ticket

​
Tips

  • Attach tickets before asking the agent to research — it will use the ticket context to produce better plans
  • You can attach multiple tickets to a single plan if they’re related
  • The agent can update Linear based on progress, keeping your project management in sync

​
Get help

If you have any issues, please reach out to help@ref.tools. We’re happy to help you get started!