Hook installation

Updated Jan 30, 2026

Claude Code hooks can automatically enqueue and dequeue messages.

Install hooks

Run:

q-install-hooks

By default, the installer looks for settings.json in:

  • $XDG_CONFIG_HOME/claude/settings.json
  • ~/.claude/settings.json

If hook executables are missing from PATH, installation fails unless the --force flag is used.

Dry run

To preview changes without writing:

q-install-hooks --dry-run

Uninstall hooks

Run:

q-uninstall-hooks

The --dry-run flag shows which hooks would be removed based on the current settings file.