This document outlines the functionality and characteristics of the Linear Issue Reader node, which enables automated issue retrieval from Linear workspaces.

Node Inputs

Required Fields

  • Filters: Select filtering criteria:

    • Team (e.g., “Engineering”, “Marketing”)
    • Status (e.g., “In Progress”, “Done”)
    • Priority (e.g., “High”, “Urgent”)
    • Labels (e.g., “Bug”, “Feature”)
    • Assignee (specific team members)
  • Issue Information: Choose data to retrieve:

    • Description
    • Identifier
    • Title
    • URL
    • Assignee
    • Status

Optional Field

  • Number of Issues: Limit number of issues to retrieve

Note: Use ‘Configure Inputs’ option to make any field dynamic for Loop Mode operations.

Node Output

Selected issue information provided as lists (string[]).

Node Functionality

The Linear Issue Reader node retrieves issues based on specified filters.

Key features include:

  • Multiple filtering options
  • Custom field selection
  • Issue count control
  • Team filtering
  • Secure authentication with Gumloop

When To Use

The Linear Issue Reader node is valuable for project tracking and analysis. Common use cases include:

  • Issue Tracking: Monitor open issues and progress
  • Workload Analysis: Review team assignments
  • Project Reporting: Generate issue status reports
  • Priority Management: Track high-priority items

Some specific examples:

  • Collecting all high-priority issues
  • Generating team workload reports
  • Tracking unassigned issues
  • Monitoring project bottlenecks

Important Considerations:

  1. Requires Authentication with Linear - Set up in the Credentials page
  2. At least one filter required
  3. Must select minimum one information field
  4. All outputs are in list format

In summary, the Linear Issue Reader node streamlines issue tracking and analysis from Linear workspaces, supporting various filtering options for efficient project management.