This GitHub action starts a Coder Task and optionally posts a comment on a GitHub issue. It's designed to be used as part of a wider workflow.

• When creating a Coder task, you must specify the Github user ID as an input.
• The action then queries the Coder deployment to find the Coder user associated with the given Github user ID.
  • Note that this requires the Coder deployment to be configured with GitHub OAuth and for the Coder user to have linked their GitHub account.
  • If no corresponding Coder user is found, the action will fail.
• The action will then create a Coder Task for the user with the given template and prompt.
• Once the task has been created successfully, the action will post a comment on the GitHub issue with the task URL.

• A running Coder deployment (v2.28 or higher) accessible to the GitHub Actions runner.
• A Tasks-capable Coder template
• A Coder session token with the required permissions to:
  • Read all users in the given organization
  • Create tasks for any user in the given organization

The below example will start a Coder task when the coder label is applied to an issue.

name: Start Coder Task

on:
  issues:
    types:
      - labeled

permissions:
  issues: write

jobs:
  coder-create-task:
    runs-on: ubuntu-latest
    if: github.event.label.name == 'coder'
    steps:
      - name: Coder Create Task
        uses: coder/create-task-action@v0
        with:
          coder-url: ${{ secrets.CODER_URL }}
          coder-token: ${{ secrets.CODER_TOKEN }}
          coder-organization: "default"
          coder-template-name: "my-template"
          coder-task-name-prefix: "gh-task"
          coder-task-prompt: "Use the gh CLI to read ${{ github.event.issue.html_url }}, write an appropriate plan for solving the issue to PLAN.md, and then wait for feedback."
          github-user-id: ${{ github.event.sender.id }}
          github-issue-url: ${{ github.event.issue.html_url }}
          github-token: ${{ github.token }}
          comment-on-issue: true