unclaude.py

A developer released unclaude.py, an open-source Git hook that automatically removes Anthropic's Co-Authored-By lines from commit messages generated by Claude Code. The script, available under the Unlicense, can be installed as a commit-msg hook or used to rewrite recent commits, with backup and restore functionality.

| /usr/bin/env python3 | | | SPDX-License-Identifier: Unlicense | | | | | | Adds an impressive feature from VSCode and Vim to Claude Code: | | | the ability to edit code without signing the guest book in every commit. | | | | | | Usage: | | | Install as a repository-local commit-msg hook: | | | curl -fsSL https://gist.githubusercontent.com/Garfield1002/1a3fe1f601f5c36257a1c98b414f7141/raw/unclaude.py | install -m 0755 /dev/stdin .git/hooks/commit-msg | | | | | | Rewrite the most recent commit message: | | | unclaude.py --fix-previous | | | | | | Rewrite the last N commits on HEAD's first-parent history: | | | unclaude.py --fix-previous 5 | | | | | | When installed directly as a hook, invoke it like this: | | | .git/hooks/commit-msg --fix-previous 5 | | | | | | Warning: | | | --fix-previous rewrites Git history. Rewritten commits receive new object | | | IDs, and affected commit signatures are removed because they are no longer | | | valid. Do not rewrite published commits without coordinating a force-push. | | | | | | The script creates a backup under: | | | refs/strip-anthropic-backup/ | | | | | | A backup can be restored with: | | | git reset --keep refs/strip-anthropic-backup/<backup-name | | | | | | This is free and unencumbered software released into the public domain. | | | | | | Anyone is free to copy, modify, publish, use, compile, sell, or distribute | | | this software, either in source code form or as a compiled binary, for any | | | purpose, commercial or non-commercial, and by any means. | | | | | | In jurisdictions that recognize copyright laws, the author or authors of | | | this software dedicate any and all copyright interest in the software to the | | | public domain. We make this dedication for the benefit of the public at large | | | and to the detriment of our heirs and successors. We intend this dedication | | | to be an overt act of relinquishment in perpetuity of all present and future | | | rights to this software under copyright law. | | | | | | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | | | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | | | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | | | AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN | | | ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION | | | WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. | | | | | | For more information, please refer to <https://unlicense.org/ . | | | from future import annotations | | | import argparse | | | import re | | | import subprocess | | | import sys | | | from dataclasses import dataclass | | | from datetime import datetime, timezone | | | from pathlib import Path | | | from typing import Sequence | | | ANTHROPIC COAUTHOR = re.compile | | | rb""" | | | ^ \t | | | co-authored-by \t : \t | | | ^\r\n | | | < \t noreply@anthropic\.com \t | | | \t | | | ?:\r\n|\n|\r|$ | | | """, | | | re.IGNORECASE | re.MULTILINE | re.VERBOSE, | | | | | | SIGNATURE HEADERS = { | | | b"gpgsig", | | | b"gpgsig-sha256", | | | } | | | class ScriptError RuntimeError : | | | """An expected, user-facing failure.""" | | | @dataclass frozen=True | | | class HeaderRecord: | | | key: bytes | | | lines: tuple bytes, ... | | | def strip anthropic attribution message: bytes - tuple bytes, int : | | | """Remove Anthropic Co-Authored-By lines from a commit message.""" | | | newline match = re.search rb"\r\n|\n|\r", message | | | newline = newline match.group 0 if newline match else b"\n" | | | cleaned, count = ANTHROPIC COAUTHOR.subn b"", message | | | if count == 0: | | | return message, 0 | | | Removing a final trailer commonly leaves an otherwise useless blank line. | | | lines = cleaned.splitlines keepends=True | | | while lines and not lines -1 .strip b" \t\r\n" : | | | lines.pop | | | cleaned = b"".join lines .rstrip b"\r\n" | | | if cleaned: | | | cleaned += newline | | | return cleaned, count | | | def run git | | | args: Sequence str , | | | , | | | input bytes: bytes | None = None, | | | check: bool = True, | | | - subprocess.CompletedProcess bytes : | | | try: | | | result = subprocess.run | | | "git", args , | | | input=input bytes, | | | stdout=subprocess.PIPE, | | | stderr=subprocess.PIPE, | | | check=False, | | | | | | except OSError as exc: | | | raise ScriptError f"could not execute Git: {exc}" from exc | | | if check and result.returncode = 0: | | | detail = result.stderr.decode "utf-8", errors="replace" .strip | | | command = "git " + " ".join args | | | raise ScriptError | | | f"{command} failed: {detail or 'unknown error'}" | | | | | | return result | | | def ensure git repository - None: | | | result = run git "rev-parse", "--git-dir" , check=False | | | if result.returncode = 0: | | | raise ScriptError | | | "--fix-previous must be run inside a Git repository" | | | | | | def parse commit | | | raw commit: bytes, | | | - tuple list HeaderRecord , bytes : | | | try: | | | raw headers, message = raw commit.split b"\n\n", 1 | | | except ValueError as exc: | | | raise ScriptError | | | "encountered a malformed Git commit object" | | | from exc | | | records: list HeaderRecord = | | | current: list bytes = | | | for line in raw headers.split b"\n" : | | | if line.startswith b" " : | | | if not current: | | | raise ScriptError | | | "encountered a malformed continued commit header" | | | | | | current.append line | | | continue | | | if current: | | | key = current 0 .split b" ", 1 0 | | | records.append | | | HeaderRecord key=key, lines=tuple current | | | | | | current = line | | | if current: | | | key = current 0 .split b" ", 1 0 | | | records.append | | | HeaderRecord key=key, lines=tuple current | | | | | | return records, message | | | def parent ids records: Sequence HeaderRecord - list str : | | | parents: list str = | | | for record in records: | | | if record.key = b"parent": | | | continue | | | try: | | | , value = record.lines 0 .split b" ", 1 | | | except ValueError as exc: | | | raise ScriptError | | | "encountered a malformed parent header" | | | from exc | | | parents.append value.decode "ascii" | | | return parents | | | def rebuild commit | | | records: Sequence HeaderRecord , | | | message: bytes, | | | rewritten parents: dict str, str , | | | - tuple bytes, int : | | | output: list bytes = | | | stripped signatures = 0 | | | for record in records: | | | if record.key in SIGNATURE HEADERS: | | | stripped signatures += 1 | | | continue | | | if record.key == b"parent": | | | try: | | | , old parent bytes = record.lines 0 .split b" ", 1 | | | except ValueError as exc: | | | raise ScriptError | | | "encountered a malformed parent header" | | | from exc | | | old parent = old parent bytes.decode "ascii" | | | new parent = rewritten parents.get | | | old parent, | | | old parent, | | | | | | output.append | | | b"parent " + new parent.encode "ascii" | | | | | | continue | | | output.extend record.lines | | | raw commit = b"\n".join output + b"\n\n" + message | | | return raw commit, stripped signatures | | | def write commit object raw commit: bytes - str: | | | result = run git | | | "hash-object", "-t", "commit", "-w", "--stdin" , | | | input bytes=raw commit, | | | | | | return result.stdout.decode "ascii" .strip | | | def selected commits count: int - list str : | | | result = run git | | | | | | "rev-list", | | | "--first-parent", | | | f"--max-count={count}", | | | "HEAD", | | | | | | | | | commits = result.stdout.decode "ascii" .split | | | if not commits: | | | raise ScriptError "HEAD does not refer to any commit" | | | return commits | | | def create backup ref old head: str - str: | | | timestamp = datetime.now timezone.utc .strftime | | | "%Y%m%dT%H%M%SZ" | | | | | | suffix = old head :12 | | | base = | | | f"refs/strip-anthropic-backup/" | | | f"{timestamp}-{suffix}" | | | | | | candidate = base | | | attempt = 1 | | | while | | | run git | | | "show-ref", "--verify", "--quiet", candidate , | | | check=False, | | | .returncode | | | == 0 | | | : | | | attempt += 1 | | | candidate = f"{base}-{attempt}" | | | run git "update-ref", candidate, old head | | | return candidate | | | def fix previous count: int - int: | | | ensure git repository | | | old head = | | | run git "rev-parse", "--verify", "HEAD" | | | .stdout.decode "ascii" | | | .strip | | | | | | commits newest first = selected commits count | | | parsed: dict | | | str, | | | tuple list HeaderRecord , bytes , | | | = {} | | | total removed = 0 | | | for commit id in commits newest first: | | | raw commit = run git | | | "cat-file", "commit", commit id | | | .stdout | | | records, message = parse commit raw commit | | | parsed commit id = records, message | | | , removed = strip anthropic attribution message | | | total removed += removed | | | if total removed == 0: | | | print | | | "No matching Anthropic Co-Authored-By lines " | | | f"found in {len commits newest first } commit s ." | | | | | | return 0 | | | backup ref = create backup ref old head | | | rewritten: dict str, str = {} | | | rewritten commit count = 0 | | | stripped signature count = 0 | | | Git rev-list returned newest first. Rebuild oldest first so rewritten | | | parent object IDs are available when rebuilding their descendants. | | | for commit id in reversed commits newest first : | | | records, original message = parsed commit id | | | cleaned message, removed = | | | strip anthropic attribution original message | | | | | | old parents = parent ids records | | | new parents = | | | rewritten.get parent, parent | | | for parent in old parents | | | | | | parent changed = new parents = old parents | | | if removed == 0 and not parent changed: | | | rewritten commit id = commit id | | | continue | | | raw rewritten, stripped = rebuild commit | | | records, | | | cleaned message, | | | rewritten, | | | | | | new commit id = write commit object raw rewritten | | | rewritten commit id = new commit id | | | rewritten commit count += 1 | | | stripped signature count += stripped | | | new head = rewritten.get old head, old head | | | if new head == old head: | | | raise ScriptError | | | "matching messages were found, but HEAD did not change" | | | | | | run git | | | | | | "update-ref", | | | "-m", | | | "strip Anthropic Co-Authored-By trailers", | | | "HEAD", | | | new head, | | | old head, | | | | | | | | | print | | | f"Removed {total removed} attribution line s and " | | | f"rewrote {rewritten commit count} commit s ." | | | | | | print f"Backup ref: {backup ref}" | | | if stripped signature count: | | | print | | | "Removed " | | | f"{stripped signature count} invalidated commit " | | | "signature header s .", | | | file=sys.stderr, | | | | | | return 0 | | | def clean commit message file path: Path - int: | | | try: | | | original = path.read bytes | | | cleaned, removal count = | | | strip anthropic attribution original | | | | | | if removal count: | | | path.write bytes cleaned | | | return 0 | | | except OSError as exc: | | | raise ScriptError | | | f"failed to process commit message {path}: {exc}" | | | from exc | | | def positive int value: str - int: | | | try: | | | parsed = int value | | | except ValueError as exc: | | | raise argparse.ArgumentTypeError | | | "must be an integer" | | | from exc | | | if parsed < 1: | | | raise argparse.ArgumentTypeError | | | "must be at least 1" | | | | | | return parsed | | | def parse args - argparse.Namespace: | | | parser = argparse.ArgumentParser | | | description= | | | "Remove Anthropic Co-Authored-By lines from " | | | "Git commit messages." | | | | | | | | | parser.add argument | | | "commit message file", | | | nargs="?", | | | type=Path, | | | help= | | | "commit-message file supplied by Git to a " | | | "commit-msg hook" | | | , | | | | | | parser.add argument | | | "--fix-previous", | | | nargs="?", | | | const=1, | | | type=positive int, | | | metavar="N", | | | help= | | | "rewrite the latest N first-parent commits; " | | | "defaults to 1" | | | , | | | | | | args = parser.parse args | | | if | | | args.fix previous is not None | | | and args.commit message file is not None | | | : | | | parser.error | | | "commit message file cannot be combined with " | | | "--fix-previous" | | | | | | if | | | args.fix previous is None | | | and args.commit message file is None | | | : | | | parser.error | | | "provide a commit-message file or use " | | | "--fix-previous N " | | | | | | return args | | | def main - int: | | | try: | | | args = parse args | | | if args.fix previous is not None: | | | return fix previous args.fix previous | | | return clean commit message file | | | args.commit message file | | | | | | except ScriptError as exc: | | | print f"error: {exc}", file=sys.stderr | | | return 1 | | | if name == " main ": | | | raise SystemExit main |