Our GitHub integration lets you create and link GitHub issues from your Harvestr Discoveries. You can then follow the evolution of these issues and their status in GitHub without leaving Harvestr.

To use our GitHub integration, all you need is:

Connecting your GitHub account to Harvestr is straightforward:

Once this is done, you'll be automatically redirected to your GitHub integration settings in Harvestr, where you should now see the option Remove GitHub integration.

Now that the integration is set up, a GitHub section appears in every Discovery in Harvestr.

You can now:

Once you've decided to take a Discovery to development, you can create issues in GitHub that correspond to what needs to be built.

When you click Create issue in a Discovery, a window opens where you can enter the issue's attributes: project, type, status, assignee, summary, and description.

Once created, the issue appears in GitHub with the attributes you entered and a link back to the Discovery in Harvestr. This gives your software team access to the valuable content in your Discovery, such as user feedback.

In your Discovery, you'll also see a link to the newly created issue and be able to track its status as it changes in GitHub.

Sometimes you'll want to link GitHub issues that already exist to a Harvestr Discovery.

Click the Link issue button in your Discovery. This opens a search bar where you can search a GitHub issue by its name or its key. Searching by key only works when you type the complete key.

Once you've linked the issue to your Discovery, you can follow its status from the linked Discovery.

You can view issue statuses from your Discovery table by displaying the GitHub issues field.

You can also filter Discoveries based on the properties of linked GitHub issues to track development work easily.

Unlike our Jira and Linear integrations, GitHub does not support automatic Discovery status sync. You can see an issue's status from Harvestr, but closing an issue won't automatically change the state of its linked Discovery.

To keep Discovery states current, filter your Discovery table on GitHub issue status and update the matching Discoveries in bulk.

For the GitHub user who set up the Harvestr integration, you need to set the missing GitHub organization as public at the user level in GitHub. The organization will then appear in the list when linking new or existing GitHub issues to your Discoveries in Harvestr.

If you have requests or ideas about how we could improve our GitHub integration to better suit your workflow, send us a message!

We also provide custom integrations with Jira, Linear, Trello, Gitlab, and Figma to help you stay synced with your engineering and design teams.