Linear Issue Sync

Linear Issue Sync

Check Linear for assigned issues and sync with local task management.

Instructions

Step 1: Fetch Assigned Issues

Call linear_list_issues filtered to:

• Assigned to current user
• Status not "Done" or "Canceled"

Step 2: Compare with Local Tasks

Check Tasks/ for existing files with Linear references:

• Look for linear_id in YAML frontmatter
• Identify new issues not yet in Tasks/

Step 3: Present Summary

Linear Issues (5 active):

**High Priority**
- LIN-123: Fix authentication timeout [In Progress]
- LIN-124: Update API documentation [Todo]

**Normal Priority**  
- LIN-125: Refactor user service [Backlog]

2 issues not yet in local Tasks. Create them?

Step 4: Sync Options

Step 5: Create Local Tasks

For each issue to sync, create task file:

---
title: [Issue title]
category: technical
priority: [Map from Linear priority]
status: n
linear_id: LIN-XXX
---

Example Flow

User: "What should I work on today?"

Agent:

1. Fetches Linear issues
2. Compares with local tasks
3. "You have 3 new Linear issues..."
4. Offers to create local tasks
5. Continues with planning

Notes

• Map Linear priorities to P0-P3
• Keep linear_id in frontmatter for bidirectional sync
• Update Linear status when local task completes