action.yml

name: Linear Release
description: Sync deployments with Linear releases
author: Linear

branding:
  icon: tag
  color: blue

inputs:
  access_key:
    description: Linear pipeline access key for authentication. Store this in GitHub Secrets.
    required: true
  command:
    description: Command to run. Use "sync" to create/update a release, "complete" to mark it done, or "update" to change deployment stage.
    required: false
    default: sync
  name:
    description: Custom release name. Only used with the "sync" command.
    required: false
  version:
    description: Release version identifier. Maps to CLI --release-version (e.g., "v1.2.3").
    required: false
  release_version:
    description: Alias for "version". Maps to CLI --release-version.
    required: false
  stage:
    description: Deployment stage such as "staging" or "production". Required when command is "update".
    required: false
  include_paths:
    description: Filter commits by file paths using comma-separated globs (e.g., "apps/web/**,packages/**"). Useful for monorepos.
    required: false
  log_level:
    description: Log verbosity. Use "quiet" for errors only or "verbose" for detailed progress. Omit for default output.
    required: false
  cli_version:
    description: Linear Release CLI version to install (e.g., "v0.5.0" or "latest").
    required: false
    default: latest

outputs:
  release-id:
    description: The Linear release ID
    value: ${{ steps.run.outputs.release-id }}
  release-name:
    description: The Linear release name
    value: ${{ steps.run.outputs.release-name }}
  release-version:
    description: The Linear release version
    value: ${{ steps.run.outputs.release-version }}
  release-url:
    description: URL to the Linear release
    value: ${{ steps.run.outputs.release-url }}

runs:
  using: composite
  steps:
    - name: Install Linear Release CLI
      shell: bash
      run: bash "${{ github.action_path }}/install.sh"
      env:
        CLI_VERSION: ${{ inputs.cli_version }}

    - name: Run Linear Release
      id: run
      shell: bash
      run: bash "${{ github.action_path }}/run.sh"
      env:
        LINEAR_ACCESS_KEY: ${{ inputs.access_key }}
        COMMAND: ${{ inputs.command }}
        INPUT_NAME: ${{ inputs.name }}
        INPUT_VERSION: ${{ inputs.version }}
        INPUT_RELEASE_VERSION: ${{ inputs.release_version }}
        INPUT_STAGE: ${{ inputs.stage }}
        INPUT_INCLUDE_PATHS: ${{ inputs.include_paths }}
        INPUT_LOG_LEVEL: ${{ inputs.log_level }}

    - name: Cleanup CLI binary
      if: always()
      shell: bash
      run: rm -f "${{ github.action_path }}/linear-release"