# precommit

Pre-commit hook initialization for OCaml projects.

## Overview

This tool sets up git hooks directly for OCaml projects (no Python required):
- **pre-commit hook**: Automatically formats OCaml code using `dune fmt`
- **commit-msg hook**: Removes Claude co-author lines and rejects emojis in commit messages
- **.ocamlformat**: Creates a default `.ocamlformat` file if missing

## Installation

```
opam install precommit
```

## Usage

### Initialize hooks

Run in an OCaml project directory (where `dune-project` exists):

```bash
precommit init
```

This creates:
- `.git/hooks/pre-commit` - Runs `dune fmt` on staged OCaml files
- `.git/hooks/commit-msg` - Filters commit messages
- `.ocamlformat` - Default ocamlformat configuration (if missing)

### Check status

```bash
precommit status
```

Shows which hooks are installed. Exit code is 1 if any OCaml project is missing hooks or `.ocamlformat`.

### Check git history

```bash
precommit check
```

Scans git history for commits with AI attribution patterns.

### Recursive operation

Use `-r` to operate on all OCaml projects in subdirectories:

```bash
precommit init -r
precommit status -r
precommit check -r
```

### Dry run

To see what would be created without making changes:

```bash
precommit init --dry-run
```

## Requirements

- git
- dune (for code formatting)

## Licence

MIT License. See [LICENSE.md](LICENSE.md) for details.