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:

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 login to the account you'd like to connect 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.

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 anytime.

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 Entries in HourStack

You can use GitHub issues to create entries 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 entry. Creating entries from integrations requires the same permissions as creating entries from scratch.

<aside> 💡 To create entries for yourself with this integration the my_entries permission is required.

</aside>