Skip to main content

git-notes-hooks

Automatic Git hooks to keep refs/notes/* seamlessly synchronized across all remotes on every push and pull.

PyPI Version License Python Versions

git-notes-hooks provides automated git lifecycle integration for the git-notes ecosystem. It installs zero-friction client-side git hooks into your repositories to ensure decentralized code review comments and notes travel with your commits automatically.


⚡ Quick Installation

Install from PyPI via pip:

pip install git-notes-hooks

Or using pipx:

pipx install git-notes-hooks

🚀 Usage

Navigate to any Git repository and run:

1. Install Hooks

Install the automated push/pull synchronization hooks into .git/hooks:

git-notes-hooks install

This installs:

  • post-commit: Updates local note indices on every commit
  • pre-push: Pushes refs/notes/* to origin whenever you run git push
  • post-merge: Fetches and merges remote notes from origin on git pull

2. Check Hook Status

Verify active git-notes hooks in your current repository:

git-notes-hooks status

3. Uninstall Hooks

Safely remove git-notes hooks at any time:

git-notes-hooks uninstall

🔒 History-Safe & Non-Destructive

git-notes-hooks operates strictly on Git's native note references (refs/notes/comments, refs/notes/review, refs/notes/todos). It never modifies commit SHAs, git history, or working tree files.



📄 License

Licensed under either of:

  • Apache License, Version 2.0
  • MIT License at your option.

Release files for git-notes-hooks 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for git-notes-hooks 0.1.8
File Size Uploaded
git_notes_hooks-0.1.8.tar.gz 3.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for git-notes-hooks 0.1.8
File Interpreter ABI Platform
git_notes_hooks-0.1.8-py3-none-any.whl Python 3 none any Details

Total release size: 6.2 kB

Release files / git_notes_hooks-0.1.8.tar.gz

Download URL git_notes_hooks-0.1.8.tar.gz
Size 3.5 kB
Tags Source
SHA-256 checksum
How to use checksums
100f428910ad56011f95757340ea17811840f3714aeb88ac79b0ca189363a236
BLAKE2b-256 checksum
How to use checksums
a7845e67920ebe024e83b88cab93f7001ce6137c8c21d40e58a864465c3d292a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / git_notes_hooks-0.1.8-py3-none-any.whl

Download URL git_notes_hooks-0.1.8-py3-none-any.whl
Size 2.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
50c5863a5699517a49ed035d1061c7bc0b4eba345dbc7e67164c98a63c9a0060
BLAKE2b-256 checksum
How to use checksums
2e8a1d7096c19fdda784485f6b41601dc6228badc81e3520b779362988288700
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page