GitHub Integration

The HourStack GitHub integration allows your team to schedule and track time from the issues they’re already working on in GitHub — which means no duplicating issues, interrupted workflows, or jumping back and forth between applications.

You can connect or disconnect integrations anytime through your account settings. All integrations are scoped to you personally, meaning that nobody else on your team can access your integration connection or data. You'll have access to your GitHub integration across all of your workspaces.

Other Helpful Resources:

• Scheduling With Integrations
• Manage Your Integrations

Connecting the Integration

To connect your GitHub account, navigate to your account settings and find GitHub under the available integrations and click "Connect". This will take you to GitHub to log in to the account you'd like to connect to and to authorize the HourStack app to access your GitHub account data. Once you've authorized the HourStack app, the integration will be connected and you can start using it immediately from your calendar.

Integration Settings

On your account settings page, click the "Manage" link next to your connected GitHub integration to manage the settings.

• Automatically complete issues Turn this setting on if you'd like for source GitHub issues to be completed in GitHub automatically when you complete the corresponding task in HourStack

Integration Configuration

Filtering and sorting selections you make within the integration will automatically be saved to your integration configuration so that each time you open the integration, it will be in the state you last left it, even across browsers or devices.

GitHub Repos

The GitHub integration features two primary views, the list of GitHub repos and the list of GitHub issues. To display GitHub issues, you must first select a GitHub repo as the source for the issues. The list of repos is sorted alphabetically and is sortable. You can switch the GitHub repo you want to source issues from at any time.

Filtering, Sorting, and Searching issues

Once you've selected a GitHub repo, you can narrow the list of GitHub issues further by applying a label filter or searching for an issue by name. You can also sort issues by creation date or last updated date.

Creating Tasks in HourStack

You can use GitHub issues to create tasks in HourStack by dragging and dropping them onto the calendar, or by clicking on the GitHub issue and selecting "Schedule issue" from the menu. Notes from the GitHub issue are automatically copied over to the HourStack task. Creating tasks from integrations requires the same permissions as creating tasks from scratch.

Label Assignment

• If the GitHub issue is assigned labels in GitHub that exist in HourStack, then they will be selected automatically. If you have the required permissions and the labels in GitHub have had name changes, then we’ll update the labels in HourStack to match.
• If the GitHub issue is assigned labels in GitHub that don't exist in HourStack and you have permission, the labels will automatically be created when a task is created from the GitHub issue in HourStack.

Accessing the Original GitHub Issue

Tasks in HourStack created from GitHub issues will remain linked. Content changes will not be synced between HourStack and GitHub, but from within HourStack you'll be able to directly access the GitHub issue from the task by clicking the GitHub icon, or the options dropdown when editing the task.

Manually Closing GitHub Issues from HourStack

There are a couple of options for manually closing GitHub issues from within HourStack. For automatic closing of issues when a task is completed in HourStack, see the integration settings section above.

1. From the integration sidebar, click the issue and select "Close in GitHub".
2. From the task itself, click the options menu and click "Close in GitHub".

Disconnecting the Integration

To disconnect your GitHub integration, navigate to your account settings and click the "Manage" link next to your connected GitHub integration. Click the "Disconnect" button and confirm you'd like to disconnect the integration. This will disconnect the integration from the HourStack side. To fully disconnect the integration you'll need to revoke HourStack's access under account settings > applications > authorized OAuth apps in GitHub as well.

Revoking access on the GitHub side is required if you want to switch to integrating with a different GitHub account.

Integrating with GitHub via the HourStack Browser Extension

With the HourStack Browser Extension you can easily schedule and track time on issues in GitHub whilst remaining in the web app. You can read more about how to utilize the browser extension by reading the section titled “Adding Tasks from Integrated Apps” for the following browsers:

• Google Chrome
• Firefox
• Microsoft Edge

• Connecting the Integration
• Integration Settings
• Integration Configuration
• GitHub Repos
• Filtering, Sorting, and Searching issues
• Creating Tasks in HourStack
• Label Assignment
• Accessing the Original GitHub Issue
• Manually Closing GitHub Issues from HourStack
• Disconnecting the Integration
• Integrating with GitHub via the HourStack Browser Extension