Skip to content

Load Linear Issues

Actions
Extract Linear issue references from Git commits for use in downstream actions
v1.0.0
Latest
Star (0)

Load Linear Issues

A GitHub Action that extracts Linear issue references from Git commits for use in downstream actions.

Usage

- uses: sandgardenhq/load-linear-issues@v1
  id: linear
  with:
    linear-api-key: ${{ secrets.LINEAR_API_KEY }}
    commits-count: '10'

- name: Use Linear Issues
  run: |
    echo "Found ${{ steps.linear.outputs.issue-count }} issues"
    echo "Keys: ${{ steps.linear.outputs.issue-keys }}"

Inputs

Input Required Description
linear-api-key Yes Linear API key for authentication
team-keys No Comma-separated team keys to filter (e.g., "ENG,PROD")
output-file No Path for JSON output (default: linear-issues.json)

Changeset Specification (exactly one required)

Input Description
commits-count Number of recent commits to scan
commits-since-sha Commits after this SHA
commits-shas Specific commit SHAs (comma-separated)
commits-start-sha + commits-end-sha Commit range
tags-start + tags-end Tag range
time-range-start + time-range-end ISO 8601 time range
releases-count Recent N release tags

Outputs

Output Description
issue-keys Comma-separated Linear issue keys
issue-links Comma-separated Linear issue URLs
issue-count Number of unique issues found

JSON Output Format

{
  "metadata": {
    "generatedAt": "2024-01-01T00:00:00.000Z",
    "linearBaseUrl": "https://linear.app",
    "repository": "owner/repo",
    "changeset": { "type": "commits-count", "commitsCount": 10 },
    "totalIssues": 3,
    "totalCommits": 10
  },
  "issues": [
    {
      "key": "ENG-123",
      "url": "https://linear.app/issue/ENG-123",
      "commits": ["abc123", "def456"]
    }
  ]
}

Local Testing

  1. Copy .secrets.example to .secrets and fill in your Linear API key
  2. Run: npm run build && npm run package
  3. Execute with act: act workflow_dispatch --secret-file .secrets

Development

npm install
npm run build
npm test
npm run package

License

MIT

Load Linear Issues is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Extract Linear issue references from Git commits for use in downstream actions
v1.0.0
Latest

Load Linear Issues is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.