If you use GitHub for project management, tracking time is possible with Hubstaff. The Hubstaff app allows time tracking to GitHub issues using our apps.
To enable this, you have to set it up in your Hubstaff account by following the steps below:
First, you must connect your account in order to see tasks that are assigned to you. Also, connecting an integration allows for time to be sent back to the third-party software.
Only the user with an Owner/Organization manager role on Hubstaff can set up an integration.
If you choose to write back time into GitHub issues, the time tracked will appear in the comments as shown here:
The time recorded to GitHub issues will appear as a comment on the issue page.
Step 1
First, click on Settings > Integrations on the sidebar menu in your Hubstaff account.
Step 2
Next, click on GitHub under the Project management section.
Step 3
After clicking on GitHub, you’ll be taken to the GitHub sign-in page. Sign in to your GitHub account to continue.
If you don’t have a GitHub organization, you won’t see anything at this step and won’t be able to complete the integration. The GitHub integration cannot connect with personal GitHub accounts.
In order for us to populate your GitHub organizations on our integration wizard drop-down and connect those with Hubstaff, you’ll need to remove third-party access restrictions in your GitHub organization settings. You can learn how to do this here.
Step 4
Once you’ve successfully signed in to your GitHub account, you’ll be taken to the organization selection page where you can choose the GitHub organization, you’d like to connect to Hubstaff. Once you’ve chosen the correct organization, click Next.
Step 5
After selecting your GitHub organization, you can choose which repositories you’d like to connect to Hubstaff as projects. You may choose to sync all existing repositories or select them from a list. Adding GitHub projects is not possible with our integration.
Choose which repositories you wish to connect to Hubstaff then click on the Confirm button. If the project name doesn’t exist in Hubstaff yet, a new project with the same name will be created automatically.
Step 6
Choose which users you need to work on your GitHub integration. You have the option to either select/unselect all users, choose individual users, or automatically add new users. Click Finish to complete your integration set-up.
Step 7
Each user added to the integration will receive a confirmation email with a link to authenticate their account. They can also authenticate via the message in the notification center (the Bell icon in the top bar).
Clicking on the confirmation link will take them to the sign-in page on GitHub.
Click on the Connect button to sign-in to your GitHub account.
Step 8
Once all users have successfully authenticated with GitHub, you’ll see the tasks assigned to them on the Sidebar > Project management > To-dos page as shown below:
Step 9
To track time to the integrated task, open your Hubstaff app, then click the project name. The issues should appear on the right-hand side of the app. Click the Play button next to an issue name to begin tracking time to them.
After connecting your repositories/projects and users, your users will be able to track time on their assigned issues from the Hubstaff app. When they are closed, the time spent working on them will be sent back to GitHub and posted in a comment on the issue.
Tasks might not sync right away. It can take approximately 5 minutes after linking your team. Also, please keep in mind that each time you add a new project or user to your project management tool, the integration needs be refreshed in Hubstaff for those changes to take effect, then link those accordingly. you may also manually retry synchronization by following the steps here.
Currently, when you add a new project to the project management third-party provider, you need to access the integrations page in Hubstaff > refresh the projects list > link the new project > assign team members to the Hubstaff project that’s linked to the newly added project.
This integration supports logging time back to the integration as comments. To learn more, click here.
Tasks can be completed outside Hubstaff in the project management tool to have the time synced as well.
Tasks synchronized with integration will remain in Hubstaff as a simple task if the integration is deleted.
