Skip to content
Herding Cats

GitHub

Herding Cats integrates with GitHub to automatically create a task when issues and/or pull requests are opened on repositories you care about.

Setting up a webhook in GitHub

  • Generate a webhook URL from your User Settings page, and copy it.

  • Go to GitHub and create a webhook for a single repository, or all repositories for an organisation, as specified in GitHub’s docs. You’ll need to paste in the URL you just copied as the “Payload URL”, set the content type to application/json, and subscribe to the “Issues” and/or “Pull requests” events as desired.

What the webhook does

Once you’ve configured a webhook for a repository or organisation, a task will be automatically created whenever an issue or pull request is open, depending on what events you subscribed to. These tasks will go straight into your main list, with a title that looks like ‘Triage “Some issue” on your-user/your-repo’. The task notes will contain a link to the issue/pull request. You probably want to immediately rename the task to something meaningful, and update the status and other metadata to match what the work will involve for you.

If you’d like the ability to add tasks from other events, or have any other feedback or ideas about the GitHub integration, please let me know.