setup ¶

1. install the GitHub Application on the relevant repositories

2. add the GitHub action to your workflow as the last step in your job:

       - uses: pre-commit-ci/[email protected]
         if: always()
   

note: the step must have either the default name or contain the text pre-commit-ci-lite. the application uses this to find the right workflow.

note: the step must be contained in a job which is either by itself in the workflow or is the last job to finish in the workflow.

differences with full version ¶

pre-commit.ci lite only provides auto fixing of PRs, but allows the flexibility of using GitHub Actions as a runner.

example using pre-commit/action ¶

technically pre-commit.ci lite works for any code modification, though it was built with pre-commit in mind. here is an example workflow:

on:
  pull_request:
  push:
    branches: [main, test-me-*]

jobs:
  main:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/[email protected]
    - uses: actions/[email protected]
      with:
        python-version: 3.x
    - uses: pre-commit/[email protected]
    - uses: pre-commit-ci/[email protected]
      if: always()

pricing ¶

pre-commit.ci will always be free for open source repositories.

for private and organization repository support see the GitHub Marketplace (coming soon!).

for single-tenant or larger installations, contact [email protected].