GitHub

GitHub is the world's leading platform for software development and version control using Git. It provides a collaborative environment where developers can host and review code, manage projects, and build software together.

With GitHub, you can:

• Host repositories: Store your code in public or private repositories with version control
• Collaborate on code: Use pull requests to propose changes, review code, and merge contributions
• Track issues: Create, assign, and manage issues to organize work and track bugs
• Automate workflows: Use GitHub Actions to build, test, and deploy code automatically
• Manage projects: Organize work with project boards, milestones, and task tracking
• Document code: Create and maintain documentation with GitHub Pages and wikis

In Sim, the GitHub integration enables your agents to interact directly with GitHub repositories and workflows. This allows for powerful automation scenarios such as code review assistance, pull request management, issue tracking, and repository exploration. Your agents can fetch repository data, analyze code changes, post comments on pull requests, and perform other GitHub operations programmatically. This integration bridges the gap between your AI workflows and your development processes, enabling seamless collaboration between your agents and your development team.

Usage Instructions

Integrate Github into the workflow. Can get get PR details, create PR comment, get repository info, and get latest commit. Can be used in trigger mode to trigger a workflow when a PR is created, commented on, or a commit is pushed.

Tools

github_pr

Fetch PR details including diff and files changed

Input

Output

github_comment

Create comments on GitHub PRs

Input

Output

github_repo_info

Retrieve comprehensive GitHub repository metadata including stars, forks, issues, and primary language. Supports both public and private repositories with optional authentication.

Input

Output

github_latest_commit

Retrieve the latest commit from a GitHub repository

Input

Output

github_issue_comment

Create a comment on a GitHub issue

Input

Output

github_list_issue_comments

List all comments on a GitHub issue

Input

Output

github_update_comment

Update an existing comment on a GitHub issue or pull request

Input

Output

github_delete_comment

Delete a comment on a GitHub issue or pull request

Input

Output

github_list_pr_comments

List all review comments on a GitHub pull request

Input

Output

github_create_pr

Create a new pull request in a GitHub repository

Input

Output

github_update_pr

Update an existing pull request in a GitHub repository

Input

Output

github_merge_pr

Merge a pull request in a GitHub repository

Input

Output

github_list_prs

List pull requests in a GitHub repository

Input

Output

github_get_pr_files

Get the list of files changed in a pull request

Input

Output

github_close_pr

Close a pull request in a GitHub repository

Input

Output

github_request_reviewers

Request reviewers for a pull request

Input

Output

github_get_file_content

Get the content of a file from a GitHub repository. Supports files up to 1MB. Content is returned decoded and human-readable.

Input

Output

github_create_file

Create a new file in a GitHub repository. The file content will be automatically Base64 encoded. Supports files up to 1MB.

Input

Output

github_update_file

Update an existing file in a GitHub repository. Requires the file SHA. Content will be automatically Base64 encoded. Supports files up to 1MB.

Input

Output

github_delete_file

Delete a file from a GitHub repository. Requires the file SHA. This operation cannot be undone through the API.

Input

Output

github_get_tree

Get the contents of a directory in a GitHub repository. Returns a list of files and subdirectories. Use empty path or omit to get root directory contents.

Input

Output

github_list_branches

List all branches in a GitHub repository. Optionally filter by protected status and control pagination.

Input

Output

github_get_branch

Get detailed information about a specific branch in a GitHub repository, including commit details and protection status.

Input

Output

github_create_branch

Create a new branch in a GitHub repository by creating a git reference pointing to a specific commit SHA.

Input

Output

github_delete_branch

Delete a branch from a GitHub repository by removing its git reference. Protected branches cannot be deleted.

Input

Output

github_get_branch_protection

Get the branch protection rules for a specific branch, including status checks, review requirements, and restrictions.

Input

Output

github_update_branch_protection

Update branch protection rules for a specific branch, including status checks, review requirements, admin enforcement, and push restrictions.

Input

Output

github_create_issue

Create a new issue in a GitHub repository

Input

Output

github_update_issue

Update an existing issue in a GitHub repository

Input

Output

github_list_issues

List issues in a GitHub repository. Note: This includes pull requests as PRs are considered issues in GitHub

Input

Output

github_get_issue

Get detailed information about a specific issue in a GitHub repository

Input

Output

github_close_issue

Close an issue in a GitHub repository

Input

Output

github_add_labels

Add labels to an issue in a GitHub repository

Input

Output

github_remove_label

Remove a label from an issue in a GitHub repository

Input

Output

github_add_assignees

Add assignees to an issue in a GitHub repository

Input

Output

github_create_release

Create a new release for a GitHub repository. Specify tag name, target commit, title, description, and whether it should be a draft or prerelease.

Input

Output

github_update_release

Update an existing GitHub release. Modify tag name, target commit, title, description, draft status, or prerelease status.

Input

Output

github_list_releases

List all releases for a GitHub repository. Returns release information including tags, names, and download URLs.

Input

Output

github_get_release

Get detailed information about a specific GitHub release by ID. Returns release metadata including assets and download URLs.

Input

Output

github_delete_release

Delete a GitHub release by ID. This permanently removes the release but does not delete the associated Git tag.

Input

Output

github_list_workflows

List all workflows in a GitHub repository. Returns workflow details including ID, name, path, state, and badge URL.

Input

Output

github_get_workflow

Get details of a specific GitHub Actions workflow by ID or filename. Returns workflow information including name, path, state, and badge URL.

Input

Output

github_trigger_workflow

Trigger a workflow dispatch event for a GitHub Actions workflow. The workflow must have a workflow_dispatch trigger configured. Returns 204 No Content on success.

Input

Output

github_list_workflow_runs

List workflow runs for a repository. Supports filtering by actor, branch, event, and status. Returns run details including status, conclusion, and links.

Input

Output

github_get_workflow_run

Get detailed information about a specific workflow run by ID. Returns status, conclusion, timing, and links to the run.

Input

Output

github_cancel_workflow_run

Cancel a workflow run. Returns 202 Accepted if cancellation is initiated, or 409 Conflict if the run cannot be cancelled (already completed).

Input

Output

github_rerun_workflow

Rerun a workflow run. Optionally enable debug logging for the rerun. Returns 201 Created on success.

Input

Output

github_list_projects

List GitHub Projects V2 for an organization or user. Returns up to 20 projects with their details including ID, title, number, URL, and status.

Input

Output

github_get_project

Get detailed information about a specific GitHub Project V2 by its number. Returns project details including ID, title, description, URL, and status.

Input

Output

github_create_project

Create a new GitHub Project V2. Requires the owner Node ID (not login name). Returns the created project with ID, title, and URL.

Input

Output

github_update_project

Update an existing GitHub Project V2. Can update title, description, visibility (public), or status (closed). Requires the project Node ID.

Input

Output

github_delete_project

Delete a GitHub Project V2. This action is permanent and cannot be undone. Requires the project Node ID.

Input

Output

Notes

• Category: tools
• Type: github