Skip to content

Nothing on a Mac can stop an agent skipping your git checks for good. Excellent notices the skip, and can move the protection to GitHub or GitLab, where the agent can't reach it.

On this page

An agent can skip your repository's git checks with --no-verify, and nothing on your Mac can stop that every time. So Excellent does two things: it notices the skip and names the commit, and it can move the protection to your git server, where the agent can't reach it.

Open the Git page from the Protection page. It lists your repositories without going online.

Notice skipped checks

Watch Commits for Skipped Checks… points that repository's git hooks at a small wrapper in its .git/excellent folder. The wrapper runs your own hooks, then marks the commit as checked. A commit made without them shows up as the finding Commits were made without your repo's checks.

Stop Watching… puts your hooks setting back.

Protect main on the server

Check GitHub and GitLab reads each repository's branch protection, using the sign-in you already have: the gh or glab tool, or a GH_TOKEN, GITHUB_TOKEN or GITLAB_TOKEN you set. Your token goes from your Mac straight to GitHub or GitLab.

Protect Main… changes that protection, after you confirm:

  • on GitHub, main can't be force pushed or deleted, and a check is required once you commit the workflow it writes;
  • on GitLab, main can't be force pushed.

For a GitHub repository whose checks are in a tracked file, it writes .github/workflows/excellent-checks.yml into the repository on your Mac, uncommitted. Commit and push it, and GitHub re-runs those checks.

Undo… on the Git page takes the protection off and removes that workflow file. Commit the deletion.

A remote on this Mac

If your project pushes to a folder on this Mac, Install Server Hook… adds a hook there that runs your checks again on each push. Remove Hook… takes it out.

Was this page helpful?

Something wrong or missing in the docs? Email hello@excellent.so.

Start here

  • StartWhat Excellent does
  • StartInstall Excellent for Mac
  • StartYour first scan
  • StartWhat it finds
  • StartFree and Pro