GitHub integration

Connect GitHub to let Agents create issues, manage pull requests, read files, and interact with repositories. GitHub is available as a set of Agent tools, not as Flow steps.

Setting up GitHub

GitHub tools are connected per Agent through the tool picker, not from a central Settings page.

  1. Open the Agent editor and add a tool from the tool picker.
  2. Choose GitHub.
  3. Create a Personal Access Token in GitHub. Use a fine-grained token with repo and read:org scopes.
  4. Paste the token (it looks like ghp_…) into the setup form and save.

The token is stored with that Agent’s tool configuration.

Available tools

Once connected, the following tools are available to Agents:

Repositories

  • list_repos — List repositories for the authenticated user or an organization
  • get_repo — Get details of a repository

Issues

  • create_issue — Create a new issue (with labels, assignees, milestones)
  • list_issues — List issues with state, label, and assignee filters
  • update_issue — Update an existing issue

Pull requests

  • create_pull_request — Create a new pull request
  • list_pull_requests — List pull requests with state and branch filters
  • get_pull_request — Get details of a pull request
  • create_pr_comment — Add a comment to a pull request

Files

  • get_file_content — Read a file from a repository (supports branch/tag/SHA refs)
  • search_code — Search for code across GitHub repositories

Enable these tools when configuring an Agent.

Use cases

  • Bug tracking: Auto-file issues from error reports
  • Code review: Comment on pull requests
  • Documentation: Create issues for missing docs
  • Release automation: Update issues when deploying

Removing GitHub access

GitHub credentials live with each Agent’s tool configuration, not in a central Settings panel. To remove access, remove the GitHub tools from the Agent (or replace the token with a new one). If the token is no longer needed anywhere, revoke it from your GitHub Developer Settings.

Next steps