feat(config): add BD_NO_INSTALL_HOOKS environment variable to disable git hook installation (#500)

* feat(config): add no-install-hooks config to disable git hook installation

Add `no-install-hooks` boolean config that prevents git hook installation
during `bd init`. This can be set via:
- Environment variable: BD_NO_INSTALL_HOOKS=1
- Global config: ~/.config/bd/config.yaml with `no-install-hooks: true`
- Local config: .beads/config.yaml with `no-install-hooks: true`

The existing `--skip-hooks` flag continues to work and takes precedence.
Default behavior unchanged: hooks install by default.

* docs: add no-install-hooks to configuration documentation

- Add no-install-hooks to Supported Settings table in CONFIG.md
- Add example in config file section
- Add "Disabling Hook Installation" section to GIT_INTEGRATION.md
  with examples for flag, env var, and config file methods
This commit is contained in:
Ryan Stortz
2025-12-13 09:38:26 -05:00
committed by GitHub
parent 074da998a7
commit 4254c3f2f5
5 changed files with 215 additions and 2 deletions

View File

@@ -34,6 +34,7 @@ Tool-level settings you can configure:
| `no-daemon` | `--no-daemon` | `BD_NO_DAEMON` | `false` | Force direct mode, bypass daemon |
| `no-auto-flush` | `--no-auto-flush` | `BD_NO_AUTO_FLUSH` | `false` | Disable auto JSONL export |
| `no-auto-import` | `--no-auto-import` | `BD_NO_AUTO_IMPORT` | `false` | Disable auto JSONL import |
| `no-install-hooks` | `--skip-hooks` | `BD_NO_INSTALL_HOOKS` | `false` | Skip git hook installation during `bd init` |
| `db` | `--db` | `BD_DB` | (auto-discover) | Database path |
| `actor` | `--actor` | `BD_ACTOR` | `$USER` | Actor name for audit trail |
| `flush-debounce` | - | `BEADS_FLUSH_DEBOUNCE` | `5s` | Debounce time for auto-flush |
@@ -59,6 +60,10 @@ flush-debounce: 10s
# Auto-start daemon (default true)
auto-start-daemon: true
# Disable git hook installation during bd init
# (useful if you manage hooks with pre-commit, husky, etc.)
no-install-hooks: true
# Daemon log rotation settings
daemon-log-max-size: 50 # MB per file (default 50)
daemon-log-max-backups: 7 # Number of old logs to keep (default 7)

View File

@@ -251,11 +251,33 @@ See [PROTECTED_BRANCHES.md](PROTECTED_BRANCHES.md) for complete setup guide, tro
### Installation
Git hooks are installed automatically during `bd init`. To install manually:
```bash
# One-time setup in each beads workspace
./examples/git-hooks/install.sh
```
### Disabling Hook Installation
If you prefer to manage git hooks separately (e.g., using pre-commit, husky, or your own hook manager), you can disable automatic hook installation:
```bash
# Via command-line flag
bd init --skip-hooks
# Via environment variable (useful for CI/scripts)
BD_NO_INSTALL_HOOKS=1 bd init
# Via global config (~/.config/bd/config.yaml)
no-install-hooks: true
# Via project config (.beads/config.yaml)
no-install-hooks: true
```
**Precedence:** `--skip-hooks` flag > `BD_NO_INSTALL_HOOKS` env var > config file > default (install hooks)
### What Gets Installed
**pre-commit hook:**