CommandsHooks
hooks status
Inspect managed and external git hook state
What It Does
hooks status reports whether the expected post-commit and post-merge hooks are installed, absent, or external.
When To Use / When Not To Use
When to use it
- You want to verify hook state before install or uninstall.
- You want a machine-readable view of hook ownership.
When not to use it
- You want to mutate hook state. Use
hooks installorhooks uninstall.
Syntax
pnpm ragit hooks status [--format text|json|both] [--cwd <path>]
Arguments And Options
--format text|json|both: Choose text, JSON, or both.--cwd <path>: Run against another repository.
Input And Output Contract
- Input is flag-based only.
- JSON output includes
dryRun,root, andhooks. - Each hook item reports
name,target,action, andstate.
Examples
Human terminal flow:
pnpm ragit hooks status
Agent-oriented flow:
pnpm ragit hooks status --format json
Failures And Cautions
- External hooks are not an error by themselves; they are a signal to avoid destructive automation.
hooks statusdoes not confirm that the hook target command succeeded in previous runs. It only inspects file state.