GitHub integration
Webhook settings, labels and /agent commands, replies with a token, and pull request reviews for GitHub and GitHub Enterprise.
Step-by-step: Turn GitHub issues into tasks and Review every pull request.
Webhook
Repository Settings → Webhooks → Add webhook: the payload URL, content type application/json, the secret, and
the events Issues, Issue comments and — for reviews — Pull requests. Deliveries must carry a valid
X-Hub-Signature-256.
Settings
| Setting | Default | Effect |
|---|---|---|
| Project | — | Where tasks are created |
| Label | agent | Issues opened with it, or labelled later, become tasks. Empty: every new issue |
| Command | /agent | Comments starting with it create a task from the rest of the comment |
| Token secret for replies | — | Name of an organization secret holding a token that may comment |
| API base URL | github.com | For GitHub Enterprise, e.g. https://github.example.com/api/v3 |
| Review pull requests | off | When opened, or When opened and on every push |
Comments by bots are ignored.
Replies
With a reply token, the issue gets a comment with the task link when the task is created, and another when it completes, fails or needs attention. Reviews are posted as pull request reviews of type comment, with line comments where the agent gave a line.
For repository sync and pull requests from tasks, see the GitHub App.