# GitHub

Pull requests, checks, and issues on GitHub.

Run these through `omni-cli` once a human has connected the platform (`omni-cli github login`). Full parameter and output schemas come from `omni-cli discovery github`.

## checks

| Command | What it does | Kind |
|---|---|---|
| `omni-cli github checks list` | List check runs and commit statuses for a ref, with rollup. | read |

## issues

| Command | What it does | Kind |
|---|---|---|
| `omni-cli github issue create` | Create an issue. | write |
| `omni-cli github issue get` | Get an issue. | read |
| `omni-cli github issue list` | List or filter issues. | read |

## pull requests

| Command | What it does | Kind |
|---|---|---|
| `omni-cli github pr add-comment` | Add an issue-style comment to a pull request. | write |
| `omni-cli github pr create` | Open a new pull request. | write |
| `omni-cli github pr diff` | Get the unified diff of a pull request. | read |
| `omni-cli github pr get` | Get a pull request. | read |
| `omni-cli github pr list` | List or filter pull requests. | read |
| `omni-cli github pr list-comments` | List the comments on a pull request. | read |
| `omni-cli github pr merge` | Merge a pull request. | write |
| `omni-cli github pr review` | Submit a pull request review. | write |

## repositories

| Command | What it does | Kind |
|---|---|---|
| `omni-cli github repo list` | List repositories accessible to the authenticated user (discovers repo slugs). | read |

## actions

| Command | What it does | Kind |
|---|---|---|
| `omni-cli github workflow list` | List repository workflows. | coming soon |