icon-flow

GitHub Workflows

Streamline my GitHub Workflow

We're always releasing new features to help development teams track their work more simply and efficiently. Below, learn how to save hours per week with ZenHub's time-saving features.

Integrations

Want to stay in the loop across any device? ZenHub provides integrations with industry standards like Slack, HipChat, Spark, Gitter, or something totally custom.

To configure an integration, visit the ZenHub Dashboard and select the Integrations tab. Here, you can configure ZenHub to post important GitHub project updates to third-party services. Your team will be kept updated on important project changes related to ZenHub, and you can further pair it with GitHub's integrations for an even more comprehensive picture of your team's project activity.

You can be updated when...

  • An issue changes from one pipeline to another ( i.e. from “In Progress” to “Review” )
  • An estimate is set, updated, or cleared
  • An issue is moved up or down in a pipeline ( reprioritized )

Adding an integration

To add a new integration, visit the Integrations tab on the ZenHub Dashboard, then choose a service to integrate with.

Select the GitHub repository you'd like updates for, then follow the instructions to generate a webhook. (Note that the “How to create a webhook” link changes depending on the service you've selected. If you've selected Slack, you'll be able to use the simple Add to Slack button.) Finally, add the generated webhook to complete the integration.

ZenHub API

Want to generate custom reports or manipulate your team's ZenHub data? ZenHub provides an REST API with JSON responses for this purpose. See the full API documentation. ZenHub's API can be used alone or in tandem with GitHub's robust API.

The ZenHub API provides a variety of endpoints. Current endpoints include:

  • Issue data (An issue's Estimate, pipeline, and a true/false epic flag)
  • Issue events (Historical changes to a specific GitHub issue)
  • Board data for a repository (Board pipelines, the issues in each pipeline; plus issue numbers, issue position on the board, estimates, and a true/false epic flag)
  • Epics for a repository
  • Epic data (including estimates and position on the Board)

Repo Switcher

The handy Repo Switcher allows you to filter and switch repositories instantly. Click the drop-down or press f to toggle between repositories within your organization.

repo-switcher

ToDo - Personal GitHub issue management

todo-page

Managing personal tasks in GitHub can be a challenge, especially if you're part of several repositories. Inspired by the Getting Things Done productivity methodology, ToDo allows software developers and PMs to manage issues and pull requests as personal tasks. You can create unlimited private to-do lists, and you can add, remove, and triage your tasks without leaving the GitHub interface.

Find the Bolt button in the top-right corner of issues and pull requests. Click the Bolt (or press shift-z) to add it as a personal task in your private inbox.

todo-button

View your action items by clicking ToDo in the top navigation (or use the shortcut z). When you add a task, it will appear in your personal inbox, ready to be triaged into its proper place. Drag top-priority items under the Today list.

Once you decide what you'll work on today, build customized lists to triage the rest of your inbox. Your methodology is up to you: one popular approach is sorting items by Today, Tomorrow, and Someday; others build out lists for each individual project they're working on.

Keyboard Shortcuts

  • b
  • p
  • e
  • d
  • Shift z
  • z
  • f
  • ?

Move Issue button

highlight-move-issue-button

Find the Move Issue button on the bottom-right corner of a GitHub issue. By clicking this button, you can move an issue and its comments into another repository. You'll have the option to close the issue when it's moved, or simply to make a duplicate.

move-issue-button