GitHub Issues

Table of contents:

• Introduction

• Prerequisites

• Connecting the Aikido App to GitHub Issues

  • Options for Task Creation in GitHub Issues via Aikido

• Manual Task Creation

• Automated Task Creation

  • Setup GitHub Issues Integration Now →

  • Discover Integration Details →

GitHub Issues

📋 Setting up automated task creation in GitHub Issues

Introduction

This one-time setup per workspace allows everyone in your Aikido organization to create issues directly in GitHub Issues

Following use cases are supported :

• Manual Ticket Addition: Manually sync security issue tickets to GitHub Issues.

• Automated Ticket Creation: Automatically create and push tickets to specified GitHub Issue projects/repos.

All issues will be automatically created in the respective repo. If you wish to disable this functionality, contact us.

Prerequisites

• GitHub account needs to be an organisation account

• Issues need to be enabled inside GitHub

Connecting the Aikido App to GitHub Issues

1. Navigate to Integration Settings within the Aikido app.

2. In the 'Task Trackers' section, select 'GitHub Issues'

3. Install the Issues App inside your organisation (Install Link). This is needed in order to select your organisation. ​

   

   GitHub issue-tracking integration setup requires authorization and organization configuration.
4. Select your organisation and repos ​

   

   Aikido Issues installation prompt with user selection interface.
5. When installed succesfully, you will get a notification on top of the page in GitHub. Return to Aikido. ​

   

   Notification confirming "Aikido Issues" was updated for the specified user account.
6. Select your organisation in the modal. ​

   

   Dropdown menu for selecting an organization in settings.
7. Click Save. The status will now change to Connected.

   

   GitHub issue-tracking integration successfully connected and ready for use.
8. Close the modal & open the GitHub Issues Integration page. By default all issues will be synced to the 'Default Repo'. Contact us if you'd like to have autosyncing issues to the respective repo.

1. You can set a Default Label that will be send for all Aikido Issues. These will be synced and appear in GitHub.​ ​

   

   Open GitHub issue for minor aws/aws-sdk-php upgrade, labeled low priority security fix.

Options for Task Creation in GitHub Issues via Aikido

There are two different options to create new tasks from Aikido into GitHub Issues

1. Manually create tasks from the Aikido interface

2. Automatically create new tasks via Aikido's auto creation functionality.

Manual Task Creation

1. Hover over any issue in your feed and click the + in the assignee column. ​

   

   Task management interface showing "Assignee" column with add and options buttons.

   Alternatively, you can click the triple dots in the last columns to open up the action menu. If you have grouped issues, the triple dot action menu is available on every subissue. ​

   

   Dropdown menu with task management actions: create, snooze, ignore, copy link, adjust severity.
2. Fill in the required details in the popup modal. ​

   

   Form for creating a new GitHub issue task with project, assignee, and description fields.

   ​

3. The newly created task in GitHub Issues will be linked in the Aikido Issue Detail under the 'Tasks' tab (sidepanel).

Task management dashboard showing a low-priority AWS SDK PHP upgrade task.

Automated Task Creation

Aikido will automatically create tasks every night in bulk. There is at the moment no option to trigger this manually.

1. Go to the GitHub Integration settings page

2. Make sure to enable 'Autocreation' by clicking the toggle to On.

3. Define the criteria for automatic task creation. ​

   

   Task autocreation settings: enable automatic creation for critical issues, limited to one task per day.

   ​

4. Aikido will then autonomously generate GitHub Issues based on these settings 🚀

---