Skip to main content

Run Tasks from GitHub Issues

Bosun can trigger tasks directly from GitHub issues. Mention the Bosun GitHub App in an issue comment and choose the action you want to run—the platform takes care of the rest.

Prerequisites​

  • The Bosun GitHub App is installed on your organization and the repository you want to automate.
  • For multi-repository tasks, make sure the app is installed (or granted access) on every target repository inside the organization so Bosun can reach each codebase.
  • You have write access to the repository. Commands from users without write access are ignored for safety.

Even with multi-repo coverage enabled, Bosun only acts inside repositories where the app is installed and the commenter has write access, so stray mentions never trigger work elsewhere.

Supported Commands​

Start a comment with @bosun-ai followed by one of the commands below:

  • fix — run the built-in fix_github_issue task. Bosun pulls the issue details, lets an agent address the problem, and opens a pull request referencing the issue.
  • triage — run the triage_github_issue task. Bosun reviews the issue, adds guidance for maintainers, and comments back with its findings.
  • run <task-name> — run any saved Bosun task from your organization, using the issue number as the github_issue_number input.

Tips​

Issue hygiene
  • Automation runs only when the comment is newly created; editing a comment does nothing.
  • Type the task name exactly as it appears in Bosun when using run.
  • Mention available commands inside your issue templates so contributors know what to expect.