This integration creates Asana Tasks from GitHub issues. Once linked, Asana issues will be updated when Issues are updated or commented upon. The linked Asana Task will be completed when the GitHub issue is closed.

Tasks are a better mirror of Issues than Pull Requests. Issues are created because something needs doing, eg. there is a task to be done. Pull Requests are often created specifically to resolve an issue, eg. to complete a task.

Because development happens on GitHub, having Issues attached to the code greatly reduces developer friction and prevents flow-breaking context shifts. Issues are attached to the code, and can be updated and resolved as part of the normal Git workflow. Issue creation is significantly more robust and faster using GitHub on Mobile, so QA can happen anywhere on a single device -- activating Mobile-friendly in-between spaces like subway commutes and other downtime.

To use this action, add a workflow like this to your repo:

name: GitHub Issues to Asana Tasks

on:
  issues:
    types: [opened, closed, reopened]
  issue_comment:
    types: [created]

jobs:
  issues-to-tasks:
    runs-on: ubuntu-latest

    steps:
      - name: GitHub Issues To Asana Tasks
        uses: ideasonpurpose/[email protected]
        env:
          ASANA_PAT: ${{ secrets.ASANA_PAT }}

After adding the GitHub Action to a repository, two things are required for the action to do anything. The repository or organization must have an Asana Personal Access Token stored as a GitHub Secret named ASANA_PAT, and the issue must include an Asana Project Link in its Issue description.

• On Issue Creation
  For newly created Issues, the Action will attempt to create a new Task in Asana, in the project linked in the description. New Tasks will appear at the top of the first group (column/list) but can be moved anywhere in the project. The GitHub Issue's description will be used to populate the task note, along with a link back to the Issue.

• On Issue Updates (comments)
  For existing issues containing an Asana Project link, the Action will search the Project for a Task whose note contains the GitHub Issue permalink. If found, that Task will be updated with the new Issue comment.

• On Issue Closed/Re-opened
  For existing issues containing an Asana Project link, the Action will search the Project for a Task whose note contains the GitHub Issue permalink. If found, that Task's completed status will be updated.

API operations authenticated with Personal Access Tokens will assume the identity of the user who created the token. We recommend creating a bot account in your Asana workspace. Log in as the bot user and follow Asana's documentation for creating a Personal Access Token.