⚙️📄 Report the results from knip on pull requests.

This action runs knip, parses the results, and posts the report as comments on the related pull request.

The execution of knip requires you to have followed the general knip setup and have a command script present in your package.json file, knip, by default but this can be of any name. If this script name deviates from the standard knip setup, please provide the script name in the config.

knip-reporter appends a reporter to the knip command used, --reporter json, to output a parseable report with information needed for annotations where supported.

name: Pull Request
on:
  pull_request:

# This permissions config is only required if you are
# not providing own permissive token
permissions:
  checks: write
  issues: write
  pull-requests: write

steps:
  - name: Post the knip results
    uses: codex-/knip-reporter@v2

The following inputs are supported

If you encounter a case where comments are not being posted, or known sections are missing from the report, please enable step debug logging and create an issue with the results and expected behaviour.

• Checks
  • Check Runs
    • Create a check run
      • POST /repos/{owner}/{repo}/check-runs
    • Update a check run
      • PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}
• Issues
  • Comments
    • Create an issue comment
      • POST /repos/{owner}/{repo}/issues/{issue_number}/comments
    • List issue comments
      • GET /repos/{owner}/{repo}/issues/{issue_number}/comments
    • Update an issue comment
      • PATCH /repos/{owner}/{repo}/issues/comments/{comment_id}
    • Delete an issue comment
      • DELETE /repos/{owner}/{repo}/issues/comments/{comment_id}