GitHub
Arcade.dev LLM tools for Github
GitHub Toolkit
The GitHub toolkit connects Arcade to GitHub, enabling LLM-powered agents to read and write across repositories, pull requests, issues, projects, and user activity using the authenticated user's identity.
Capabilities
- Repository & file management: Create branches, create or overwrite files with explicit mode control, update specific line ranges, fetch file contents (with line-range slicing), list org repos, retrieve repo details, and track repository activity history.
- Pull requests & code review: Open, update, merge, and inspect PRs; manage reviewers and labels with fuzzy matching; post review comments (line-level or file-level, diff-aware), reply to threads, resolve/unresolve conversations, and submit full reviews.
- Issues & projects: Create, update, list, and comment on issues; add issues to Projects V2; list, search, and filter project items; inspect project fields including select/iteration options.
- Search & discovery: Search code across authorized scope with inline match fragments; fuzzy-search accessible repos; list collaborators at configurable detail levels; list and manage labels.
- User & activity context: Retrieve the authenticated user's profile, orgs, and teams; surface open PRs/issues, recent activity (authored, reviewed, merged, committed), and the review workload queue.
- Starring & social signals: Star or un-star repos, count stargazers, and list individual stargazers (requires collaborator/admin access for the listing endpoint).
OAuth
This toolkit authenticates via OAuth 2.0 using the GitHub provider. See the Arcade GitHub auth provider docs for setup instructions, required app configuration, and supported scopes.
Secrets
GITHUB_SERVER_URL — Overrides the default GitHub API base URL. This is intended for use with GitHub Enterprise Server (GHES) deployments, where the API is hosted at a custom domain (e.g., https://github.your-company.com). To obtain the correct value, confirm your organization's GHES hostname with your GitHub Enterprise administrator. For standard GitHub.com usage this secret is not required. See GitHub Enterprise Server REST API docs for details on the expected URL format.
For general guidance on configuring secrets in Arcade, see the Arcade secrets docs. Secrets can also be managed at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(43)
| Tool name | Description | Secrets | |
|---|---|---|---|
Assign a user to a pull request with intelligent search and fuzzy matching. | 1 | ||
Check if a pull request is ready to merge without attempting the merge. | 1 | ||
Count the number of stargazers (stars) for a GitHub repository. | 1 | ||
Create a new branch in a repository. | 1 | ||
Create a new file or overwrite an existing file in a repository.
The explicit mode parameter reduces accidental data loss: the default CREATE mode refuses to
touch existing files, while OVERWRITE must be chosen intentionally. | 1 | ||
Create an issue in a GitHub repository.
Optionally add the created issue to a project by specifying add_to_project_number
and add_to_project_scope. | 1 | ||
Create a comment on an issue in a GitHub repository. | 1 | ||
Create a pull request in a GitHub repository. | 1 | ||
Create a reply to a review comment for a pull request.
Optionally resolve the conversation thread after replying by setting resolve_thread=True
and providing the thread_id (GraphQL Node ID). | 1 | ||
Create a review comment for a pull request in a GitHub repository.
IMPORTANT: Line numbers must be part of the diff (changed lines only).
GitHub's API requires line numbers that exist in the pull request diff, not just any line
in the file. If the line wasn't changed in the PR, the comment will fail with 422 error.
Line comments require start_line and end_line. When subject_type is omitted, providing either
line parameter selects a line comment; otherwise the comment applies to the whole file.
File comments cannot include line-specific parameters.
If the commit_id is not provided, the latest commit SHA from the PR will be used.
TIP: Use subject_type='file' to comment on the entire file if unsure about line positions. | 1 | ||
Get the contents of a file in a repository.
Returns the decoded content (if text) along with metadata like SHA, size, and line count.
For large files, use start_line and end_line to retrieve specific line ranges. | 1 | ||
Get a specific issue from a GitHub repository. | 1 | ||
Get details of a pull request in a GitHub repository. | 1 | ||
Get a repository.
Retrieves detailed information about a repository using the GitHub API. | 1 | ||
Get pull requests awaiting review by the authenticated user.
Returns PRs where user is requested as reviewer and PRs user has recently reviewed. | 1 | ||
Get user's currently open pull requests and issues across all repositories.
Returns open PRs and issues authored by the authenticated user. | 1 | ||
Get the authenticated user's recent pull requests, reviews, issues, and commits.
Returns PRs they authored, merged PRs, PRs they reviewed, issues they opened, and commits pushed | 1 | ||
List issues in a GitHub repository. | 1 | ||
List repositories for the specified organization. | 1 | ||
List fields for a Projects V2 project.
Returns all custom fields configured for the project, including field types
and available options for select/iteration fields. | 1 | ||
List items for a Projects V2 project with optional filtering. | 1 | ||
List Projects V2 across organization or user scopes. | 1 | ||
List commits (from oldest to newest) on a pull request in a GitHub repository. | 1 | ||
List pull requests in a GitHub repository.
By default returns newest pull requests first (direction=DESC).
Organization-wide search returns GitHub's reduced issue-search summary. It preserves the
merged timestamp but does not include repository-list details such as head/base metadata or
detailed mergeability and reviewer data. | 1 | ||
List repository activities.
Retrieves a detailed history of changes to a repository, such as pushes, merges,
force pushes, and branch changes, and associates these changes with commits and users. | 1 |