An Op to simplify an opinionated GitHub workflow.
Please note that this Op was built with SDK 1 and therefore is currently limited to CLI compatibility.
If you would like to interact with GitHub in Slack, please contact us in our community and we can help you.
To run this or any other Op, install the Ops Platform.
Find information about how to run and build Ops via the Ops Platform Documentation
This Op also requires an access token for GitHub interactions.
To create a GitHub access token:
Create an access token with the
adminscopes following the instructions here.
Copy the access token and provide it when prompted.
originmust be set to a valid GitHub repo.
ops run github, gives you a list of available commands to help you get started.
To develop and run Ops locally:
- Clone the repo
git clone <git url>
cdinto the directory and install dependancies with
- Run the Op from your local source code with
ops run path/to/op
All the commands start with
ops run github. From there, you would use the following commands to manage your GitHub flow.
Initializes a new git repo in the current working directory and pushes to the user's selected organization or personal Github repository. Current working directory must be git initialized.
Clones a remote repo that you are a contributor on to your current working directory.
Creates a new issue in GitHub. Current working directory must be a repo either cloned or created using the repo:create or repo:clone commands.
Lists all the issues the user has access to. If the current working directory is a repo in github then the issues are scope by the repo otherwise it displays all issues that you are assigned to or created by you etc.
Searches all issues in GitHub for your current working directory by selected filters. User can pass optional query string argument in form of
[-q <+querystring> | --query <+querystring>] for additional filters.
Please check GitHub querystring for detailed info
Lists all issues in GitHub for your current working directory. Selecting a issue will checkout a branch for that issue and set the upstream in github.
Adds all unstaged changes, commits and pushes to GitHub for the current working branch.
Converts the current working issue into a pull-request and allows you to tag reviewers.
Lists all the pull requests for a given repo. The current working directory has to be a repo.
Allows you to create a new label in a repo and sync the label addition across other repos in the organization.
Allows you to edit a label and sync the edit across other repos in the organization.
Allows you to remove label from a repo and sync the removal across other repos in the organization.
Allows you to sync up labels from one base repo to any other repo(s) that you have access to. The op will check for any missing labels in the targeted repo(s) and add in as necessary.
Allows you to update your GitHub access token.
Debugging this Op
DEBUG=github:* ops run github <command> in order to run the op in debug mode.
When submitting issues or requesting help, be sure to also include the version information output from