Daniel Avila #1256 Oct 22, 2026
  • sync-linear-to-issues.md 36 lines · 1.9 KB
sync-linear-to-issues.md

Sync Linear to Issues

Sync Linear tasks to GitHub issues with comprehensive state and field mapping: $ARGUMENTS

Current Linear Context

  • Linear teams: Available teams and project assignments
  • Task count: Linear task query to determine scope
  • Target repository: !gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "No repo context"
  • User mappings: Linear email to GitHub username correspondence

Task

Execute comprehensive synchronization of Linear tasks to GitHub issues:

Sync Scope: Use $ARGUMENTS to filter by Linear team, project, priority levels, or task states

Synchronization Framework:

  1. Task Discovery - Query Linear tasks with filters, extract metadata, validate requirements, prioritize sync
  2. State Mapping - Transform Linear states to GitHub equivalents, handle priority conversion, map project assignments
  3. Content Transformation - Build GitHub issue body, preserve formatting, handle attachments, maintain structure
  4. GitHub Integration - Create issues with proper labels, assign users, set milestones, manage relationships
  5. Attachment Migration - Download Linear attachments, upload to GitHub, update references, maintain accessibility
  6. Comment Synchronization - Transfer comments with attribution, preserve context, handle mentions, maintain threading

Advanced Features: Intelligent state mapping, attachment handling, comment threading, user mention translation, comprehensive validation.

Data Fidelity: Preserve Linear formatting, maintain task relationships, keep timestamps, ensure reference integrity.

Output: Complete synchronization results with created issues, attachment migrations, comment transfers, and comprehensive sync reporting.

Next step

More commands in sync, in alphabetical order.