Skip to main content

atmos git hooks

Install, uninstall, and run local Git hooks (pre-commit, commit-msg, pre-push, ...) configured under git.hooks in atmos.yaml. Atmos writes thin .git/hooks/* shims that delegate to atmos git hooks run, so your hooks execute through Atmos workflows and custom commands — with the toolchain, environment, and identity behavior you already have — instead of through Husky-style shell scripts.

Configure hooks once in atmos.yaml:

git:
  hooks:
    pre-commit:
      command: atmos workflow pre-commit
    commit-msg:
      command: atmos workflow commit-msg -- "$1"

Then install the shims:

atmos git hooks install
Local Git hooks vs. lifecycle hooks

Local Git hooks are triggered by Git itself (git commit, git push, ...) in the current repository. They are separate from Atmos lifecycle hooks (the git hook kind), which trigger on Atmos events like after.terraform.apply.

Subcommands​