Connecting with GitHub
How to connect
There are 2 ways to connect Github to Everhour: during the signup on step 2 and by going to the Integrations page in your account and clicking to add new integration.
Everhour will sync all team repositories you have access to. Sync happens periodically and automatically, so all new projects that you create in Github will be automatically added to your Everhour account with some delay. Everhour also changes the names of issues, milestones or repositories, if they were renamed in Github. Everhour does not connect to public repositories of your organization.
We don’t allow time tracking in archived repositories. We no longer see a connection to such project, so time entries from it disappear from Time page of members and supervisors. Admins see them as archived in Everhour and reported hours remain in reports and other dashboards.
To disable your integration with Github, go to your Integrations page. This option affects only your account, other team members are still able to track time.
Tracking time with Everhour in Github
To see the embedded timer in your Github, you need to make sure you have our browser extension installed and authorized after you established connection. To check this, open your Integrations page that will show the status of our extension for the browser where you are logged in Everhour.
When you have an extension, you can:
Track time in Github issues using the timer. You will see what other members reported into this task too.
Add time manually or edit previous time entries.
Set estimates on your issues and users who work on issues.
Making Reports with Github data
There are a number of columns that shows specific data coming from Github.
- Workspace shows the name of a Github organization.
- Project and task show the names of Github repositories and issues respectively.
- Iteration shows the name of a milestone
- Task number and status show the task id and whether it is open/closed.
- Label shows the name of Github tags.
What else you should know
There are a couple of things you should be aware of. First of all, it is not possible to connect one Github account with several Everhour profiles. We do that not to allow admins from one team to see what you track in another team.
There is also no technical possibility to make a granular workspace or team sync, deciding what projects you wish to connect and where you don’t want to track time.
We do not see Github projects as a connected project to Everhour. Instead, we sync with a repository as a project where issues are tasks.
Another important thing is to understand that we cannot always immediately deliver updates you do in Github to Everhour. For that reason, you need to resync your projects on Integrations when you delete, create or rename a project, and to resync issues of a project from the Projects page when changes are made inside a project (you renamed an issue, added a new label, edited time).