github/command-action
IssueOps commands in GitHub Actions
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Nov 26, 2025
- License
- MIT
Pinned Snippet
uses: github/command@3442f3fa1efe01bdb024b157083c337902d17372 # v2.0.3tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| github_token | The GitHub token used to create an authenticated client - Provided for you by default! | yes | ${{ github.token }} |
| status | The status of the GitHub Actions - For use in the post run workflow - Provided for you by default! | yes | ${{ job.status }} |
| command | The string to look for in comments as an IssueOps trigger/command. Example: ".lint" | yes | — |
| reaction | If set, the specified emoji "reaction" is put on the comment to indicate that the trigger was detected. For example, "rocket" or "eyes" | yes | eyes |
| success_reaction | The reaction to add to the comment that triggered the Action if its execution was successful | yes | +1 |
| failure_reaction | The reaction to add to the comment that triggered the Action if its execution failed | yes | -1 |
| allowed_contexts | A comma separated list of comment contexts that are allowed to trigger this IssueOps command. Pull requests and issues are the only currently supported contexts | yes | pull_request |
| permissions | The allowed GitHub permissions an actor can have to invoke IssueOps commands - Example: "write,admin" | yes | write,admin |
| allow_drafts | Whether or not to allow this IssueOps command to be run on draft pull requests | yes | false |
| allow_forks | Whether or not to allow this IssueOps command to be run on forked pull requests | yes | false |
| skip_ci | Whether or not to require passing CI checks before this IssueOps command can be run | yes | false |
| skip_reviews | Whether or not to require reviews before this IssueOps command can be run | yes | false |
| param_separator | The separator to use for parsing parameters in comments in IssueOps commands. Parameters will are saved as outputs and can be used in subsequent steps | yes | | |
| allowlist | A comma separated list of GitHub usernames or teams that should be allowed to use the IssueOps commands configured in this Action. If unset, then all users meeting the "permissions" requirement will be able to run commands. Example: "monalisa,octocat,my-org/my-team" | no | false |
| allowlist_pat | A GitHub personal access token with "read:org" scopes. This is only needed if you are using the "allowlist" option with a GitHub org team. For example: "my-org/my-team" | no | false |
| skip_completing | If set to "true", skip the process of completing the Action. This is useful if you want to customize the way this Action completes - For example, custom reactions, comments, etc | yes | false |
| fork_review_bypass | If set to "true", allow forks to bypass the review requirement if the operation is being made on a pull request from a fork. This option is potentially dangerous if you are checking out code in your workflow as a result of invoking this Action. If the code you are checking out has not been reviewed, then you might open yourself up to a TOCTOU vulnerability. You should always ensure that the code you are checking out has been reviewed, and that you checkout an exact commit sha rather than a ref. | yes | false |
Outputs
| name | description |
|---|---|
| triggered | The string "true" if the trigger was found, otherwise the string "false" - Just because the workflow was triggered does not mean it should continue. This is a step 1/2 check |
| continue | The string "true" if the workflow should continue, otherwise empty - Use this to conditionally control if your workflow should proceed or not. This is a step 2/2 check |
| comment_body | The comment body |
| actor | The GitHub handle of the actor that invoked the IssueOps command |
| params | The raw parameters that were passed into the IssueOps command |
| comment_id | The comment id which triggered this action |
| issue_number | The issue number which this Action was triggered on |
| initial_reaction_id | The reaction id for the initial reaction on the trigger comment |
| fork | The string "true" if the pull request is a fork, otherwise "false" |
| fork_ref | The true ref of the fork |
| fork_label | The API label field returned for the fork |
| fork_checkout | The console command presented in the GitHub UI to checkout a given fork locally |
| fork_full_name | The full name of the fork in "org/repo" format |
| sha | The commit sha if being used in the context of a pull request |
| ref | The ref if being used in the context of a pull request |
| base_ref | The base ref that the pull request is merging into (if available and run in the context of a pull request) |