git-notes-hooks

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

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.

📋 Changelog & Release Notes

[0.1.14] - 2026-10-04

• Clippy & Linter Zero-Warning Compliance: Full workspace conformance across all native components.
• UTF-8 Safe Note Truncation: Safeguarded note preview slicing against multi-byte UTF-8 and emoji sequences.
• Robust Error Handling: Added resilient logging for PR import failures.
• Ecosystem Manifest Synchronization: Unified package versioning to v0.1.14 across all components.

[0.1.11] - 2026-09-27

• Data & Refspec Integrity Validator (gn validate / gn fsck): Audits Git note refs, blob objects, and commit DAG existence.
• Asynchronous Decoupled Task Queue: Full non-blocking async execution queue in IDE extensions.
• Automated CLI Binary Installer: In-editor platform binary installer for Linux, macOS, and Windows.
• Interactive Onboarding Walkthrough: Step-by-step developer guide.

[0.1.10] - 2026-09-27

• CI Quality Gating & Merge-Readiness (gn check / gn gate): Single-command merge readiness check with --min-approvals and --no-unresolved.
• Cryptographic Note Verification (gn verify): GPG & SSH signature verification for tamper-proof Git reviews.
• Shell Auto-Completions (gn completions --install): Zero-config auto-install for Bash, Zsh, Fish, and PowerShell.

[0.1.9] - 2026-09-26

• Automated Git Hook Sync: Hardened post-commit, pre-push, and post-merge hook installation.

🔗 Links & Resources

• GitHub Repository: https://github.com/isaim0011/git-notes
• Full Ecosystem Changelog: https://github.com/isaim0011/git-notes/blob/main/CHANGELOG.md
• Issue Tracker: https://github.com/isaim0011/git-notes/issues
• Release Downloads: https://github.com/isaim0011/git-notes/releases

📄 License

Licensed under either of:

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