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.
- Open the Agent editor and add a tool from the tool picker.
- Choose GitHub.
- Create a Personal Access Token in GitHub. Use a fine-grained token with repo and read:org scopes.
- 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
- Linear integration for project management
- What are Agents? to build Agents that use GitHub tools