repos:

• repo: https://github.com/pre-commit/pre-commit-hooks rev: v4.3.0 hooks:

  • id: no-commit-to-branch # prevent direct commits to the main branch
  • id: check-yaml args: ["--unsafe"]
  • id: check-toml

  gh-aw compiles *.md agentic workflows into *.lock.yml, and also

  auto-generates .github/workflows/agentics-maintenance.yml as a

  standalone maintenance workflow. Both are generated artifacts (like

  uv.lock) and must stay byte-identical to gh aw compile output, so

  the whitespace/text hooks skip them.

  • id: end-of-file-fixer exclude: ^.github/workflows/(agentics-maintenance.yml|[^/]*.lock.yml)$
  • id: trailing-whitespace exclude: ^.github/workflows/(agentics-maintenance.yml|[^/]*.lock.yml)$
  • id: check-added-large-files args:
    • --maxkb=1024 # 1MB
    • --enforce-all # Allow to run in the whole source code, instead of only the changed files. exclude: | (?x)^( tests/models/cassettes/.| tests/cassettes/.| uv.lock )$

• repo: https://github.com/sirosen/texthooks rev: 0.6.8 hooks:

  • id: fix-smartquotes exclude: (?x)(cassettes/|^.github/workflows/(agentics-maintenance.yml|[^/]*.lock.yml)$)
  • id: fix-spaces exclude: (?x)(cassettes/|^.github/workflows/(agentics-maintenance.yml|[^/]*.lock.yml)$)
  • id: fix-ligatures exclude: (?x)(cassettes/|^.github/workflows/(agentics-maintenance.yml|[^/]*.lock.yml)$)

• repo: https://github.com/codespell-project/codespell

  Configuration for codespell is in pyproject.toml

  rev: v2.3.0 hooks:

  • id: codespell args: ["--skip", "tests/models/cassettes/*"] additional_dependencies:
    • tomli

• repo: https://github.com/zizmorcore/zizmor-pre-commit rev: v1.23.1 hooks:

  • id: zizmor

• repo: local hooks:

  • id: no-rst-syntax name: No RST syntax (use Markdown in docstrings and docs) description: | Bans RST-only constructs that mkdocstrings/Markdown won't render: foo (use single backticks) and trailing :: (use ```python fences). language: pygrep entry: '(?<!)``(?!)|::\s*$' types_or: [python, markdown]
  • id: clai-help name: clai help output entry: uv args: [run, pytest, "clai/update_readme.py"] language: system types_or: [python, markdown] pass_filenames: false
  • id: format name: Format entry: make args: [format] language: system types: [python] pass_filenames: false
  • id: lint name: Lint entry: make args: [lint] types: [python] language: system pass_filenames: false
  • id: typecheck name: Typecheck entry: make args: [typecheck] language: system types: [python] pass_filenames: false
  • id: check-cassettes name: Check cassettes entry: uv args: [run, python, scripts/check_cassettes.py] language: system files: ^tests/ pass_filenames: false